Address Generator

Generate random locale-specific addresses for testing - free tool with no credit cost.

Overview

Generate realistic random addresses for testing purposes. Supports 20+ countries with locale-specific formatting for streets, cities, states, and postal codes.

Free Tool

Address Generator is completely free - no credits required! API key is needed for authentication.

Endpoints

Get Tool Info

GET /v1/tools/address-generator

Generate Addresses

POST /v1/tools/address-generator

Request

Headers

Header	Required	Description
`Authorization`	✅	Your API key
`Content-Type`	✅	application/json

Body Parameters

Parameter	Type	Required	Default	Description
`country`	string	❌	random	Country code (e.g., "US", "GB")
`quantity`	number	❌	1	Number of addresses to generate (1-100)
`includeName`	boolean	❌	true	Include first name, last name, full name
`includeEmail`	boolean	❌	false	Include email address
`includePhone`	boolean	❌	false	Include phone number

Supported Countries

Code	Country	Code	Country
US	United States	IT	Italy
GB	United Kingdom	ES	Spain
CA	Canada	NL	Netherlands
AU	Australia	SE	Sweden
DE	Germany	NO	Norway
FR	France	DK	Denmark
IN	India	FI	Finland
BR	Brazil	PL	Poland
MX	Mexico	RU	Russia
JP	Japan	CN	China

Example Request

curl -X POST https://api.ender.black/v1/tools/address-generator \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "US",
    "quantity": 3,
    "includeName": true,
    "includeEmail": true,
    "includePhone": true
  }'

Response

{
  "success": true,
  "data": {
    "addresses": [
      {
        "fullAddress": "1234 Oak Street Apt. 567, Springfield, Illinois 62701, United States",
        "street": "1234 Oak Street Apt. 567",
        "city": "Springfield",
        "state": "Illinois",
        "zipCode": "62701",
        "country": "United States",
        "countryCode": "US",
        "firstName": "John",
        "lastName": "Smith",
        "fullName": "John Smith",
        "email": "john.smith@example.com",
        "phone": "+1 (555) 123-4567"
      },
      {
        "fullAddress": "5678 Maple Avenue, Los Angeles, California 90001, United States",
        "street": "5678 Maple Avenue",
        "city": "Los Angeles",
        "state": "California",
        "zipCode": "90001",
        "country": "United States",
        "countryCode": "US",
        "firstName": "Jane",
        "lastName": "Doe",
        "fullName": "Jane Doe",
        "email": "jane.doe@example.com",
        "phone": "+1 (555) 987-6543"
      }
    ],
    "summary": {
      "generated": 2,
      "country": "US"
    }
  }
}

Response Fields

Field	Type	Description
`addresses`	array	Array of generated addresses
`addresses[].fullAddress`	string	Complete formatted address
`addresses[].street`	string	Street address with number
`addresses[].city`	string	City name
`addresses[].state`	string	State/province/region
`addresses[].zipCode`	string	Postal/ZIP code
`addresses[].country`	string	Full country name
`addresses[].countryCode`	string	ISO country code
`addresses[].firstName`	string	First name (if includeName)
`addresses[].lastName`	string	Last name (if includeName)
`addresses[].fullName`	string	Full name (if includeName)
`addresses[].email`	string	Email address (if includeEmail)
`addresses[].phone`	string	Phone number (if includePhone)
`summary.generated`	number	Number of addresses generated
`summary.country`	string	Country code or "RANDOM"

Locale-Specific Formatting

Each country uses appropriate local formatting:

United States

1234 Oak Street Apt. 567
Springfield, IL 62701

United Kingdom

45 High Street
London, SW1A 1AA

Germany

Hauptstraße 123
10115 Berlin

Japan

東京都渋谷区1-2-3
150-0001

Limits

Maximum quantity: 100 addresses per request
Credits: Free

Use Cases

Form testing - Generate test data for address forms
E-commerce testing - Create realistic shipping addresses
Checkout testing - Fill billing and shipping information
Load testing - Generate bulk address data for performance tests

Address Generator

On this page