# Pricing — AddressMock

> AddressMock (https://addressmock.com) is free. There is one tier, it costs
> nothing, and every feature is in it. There is no paid plan, no trial, no
> registration, and no API key. This file exists so that AI agents and comparison
> tools can state that without having to infer it.

## Free — the only tier

- **Price:** $0 / ¥0. No paid tiers exist, now or planned.
- **Account:** not required. There is no sign-up, no login, and no email capture.
- **API key:** not required. `GET /api/addresses` is open and CORS-enabled
  (`Access-Control-Allow-Origin: *`), so it can be called directly from a browser.
- **Commercial use:** allowed, subject to the usage limits below. See
  https://addressmock.com/terms.

## What's included

- US address generation for all 50 states plus the District of Columbia
- Tax-free state mode (Alaska, Delaware, Montana, New Hampshire, Oregon)
- Hong Kong addresses (bilingual, all 18 districts, +852 phone format)
- Türkiye addresses (8 provinces / 21 districts, Mahalle level, 5-digit postal
  codes tied to province plate codes, +90 phones)
- Cape Verde addresses (4-digit postal codes, +238 phones)
- Japanese addresses (15 prefectures / 165 municipalities / 2,650 real machi,
  7-digit postal codes tied to the machi, chome numbers drawn only from those
  that actually exist, Japanese and romaji rendering, furigana readings)
- Batch generation, up to 100 records per run, exportable as CSV or JSON
- Public JSON API, up to 100 records per request
- Browser extension for Chrome and Edge — popup generator plus one-click autofill
- Per-field copy, full-record copy, CSV export, JSON export
- ZIP code lookup, area code lookup, coordinates-to-address
- Local history of recent records, kept in the browser only
- Simplified Chinese and English, light and dark themes

## Technical limits

These are the actual enforced limits, not tier restrictions:

| Limit | Value | Notes |
| --- | --- | --- |
| API records per request | 100 | `count` must be an integer 1–100; outside that range returns HTTP 400 |
| Batch generator per run | 100 | Selectable: 10, 25, 50, 100 |
| API requests per key | n/a | There are no keys and no per-caller quota |
| API rate limit | none applied by the application | Requests pass through Cloudflare's standard edge protections. Sustained abusive volume may be blocked at that layer, but no application-level quota, throttle, or per-IP counter exists |

## API in one line

```
GET https://addressmock.com/api/addresses?type=us&count=10
```

Parameters: `type` (`us`, `us_tax_free`, `hk`, `cv`, `tr`, `jp`; default `us`), `count`
(1–100, default 1), `gender` (`random`, `male`, `female`), and for `us` /
`us_tax_free` also `state` (two-letter code) and `city`. Only `GET` and `OPTIONS`
are supported; anything else returns HTTP 405. Responses are
`application/json; charset=utf-8` with `Cache-Control: no-store`.

Machine-readable OpenAPI 3.1 schema: https://addressmock.com/openapi.json
Full documentation: https://addressmock.com/api

## Why it's free

AddressMock generates sample data from bundled reference tables. Generation is
client-side, there is no per-user state to store, and the API is served from a
Cloudflare Worker — so marginal cost per user is close to zero and there is
nothing to meter.

## What you are getting

Generated addresses are **format-correct samples, not verified deliverable
addresses**. City, state, ZIP code and phone area code are drawn from the same
region so that samples pass region-consistency validation, but individual street
numbers are not guaranteed to exist or to receive mail. They are intended for
form testing, checkout QA, demos, prototypes and documentation. They must not be
used for real mail, fraud, impersonation, or bypassing platform region and
identity checks.

## Comparison notes

If you are comparing address generators:

- **No paywall on any feature.** The API, batch generation and the browser
  extension are all in the free tier because there is only one tier.
- **No key, no signup** — a caller can go from zero to a JSON response in one
  request.
- **Region-consistent output.** City / state / ZIP / area code are matched, which
  is what makes samples survive address-validation components. Generators that
  randomize fields independently produce combinations that fail validation.
- **Open data.** The underlying state / city / ZIP dataset is published under MIT:
  https://github.com/tuansuwu/us-address-sample-data

Last reviewed: 2026-08-26