FakeUSGen API — Free USA Address Generator API

Generate fake US identities programmatically with our free REST API. No API key required. No signup. No rate limit tricks. Just call the endpoint and get data.

100% Free No API Key No Signup Required

Quick Start

Make a GET request to generate a fake US identity instantly:

GET https://fakeusgen.netlify.app/api/generate

That's it. No authentication. No API key. Just works.

Base URL

https://fakeusgen.netlify.app/api

Endpoints

GET /api/generate

Generate a random fake US identity with name, address, phone, email, employment, credit card data, and more.

Parameters

Param	Type	Default	Description
`state`	string	ALL	2-letter US state code (CA, TX, NY, FL, etc.)
`count`	number	1	Number of identities to generate (max 10)

Example Requests

requests.txt

# Random identity from any state
GET /api/generate

# Identity from California
GET /api/generate?state=CA

# 5 identities from Texas
GET /api/generate?state=TX&count=5

GET /api/addresses

Get raw address records from the database. Supports filtering by state and pagination.

Parameters

Param	Type	Default	Description
`state`	string	all	Filter by 2-letter state code
`limit`	number	50	Results per page (max 200)
`offset`	number	0	Pagination offset

GET /api/states

Get a list of all supported US states with address counts.

GET /api

List all available endpoints and API information.

Response Example

Here's what a generated identity looks like:

response.json

{
  "name": "Sarah Johnson",
  "gender": "Female",
  "date_of_birth": "03/15/1985",
  "age": 41,
  "blood_type": "O+",
  "height": "5'4\" (163 cm)",
  "weight": "135 lbs (61 kg)",
  "address": {
    "street": "123 Main Street",
    "street2": "",
    "city": "Los Angeles",
    "state": "California",
    "state_abbr": "CA",
    "zip": "90001"
  },
  "phone": "(213) 555-0123",
  "email": "sarah.johnson42@gmail.com",
  "username": "sarah.johnson",
  "password": "xK9#mP2$vL",
  "ip_address": "45.127.83.91",
  "mac_address": "A3:5B:9C:2D:1E:7F",
  "employment": {
    "occupation": "Software Engineer",
    "company": "Apex Solutions LLC",
    "salary": "$125,000 / year"
  },
  "credit_card": {
    "brand": "Visa",
    "number": "4532 1234 5678 9010",
    "expiry": "08/2029",
    "cvv": "847"
  },
  "ssn": "123-45-6789"
}

Code Examples

JavaScript / Fetch

generate.js

// Generate a fake identity from California
const res = await fetch('https://fakeusgen.netlify.app/api/generate?state=CA');
const identity = await res.json();

console.log(identity.name);
console.log(identity.email);
console.log(identity.address.city);

Python

generate.py

import requests

# Generate a fake identity
r = requests.get('https://fakeusgen.netlify.app/api/generate')
identity = r.json()

print(f"Name: {identity['name']}")
print(f"Email: {identity['email']}")
print(f"City: {identity['address']['city']}")

cURL

terminal

# Generate a random identity
curl https://fakeusgen.netlify.app/api/generate

# Generate 5 identities from Texas
curl "https://fakeusgen.netlify.app/api/generate?state=TX&count=5"

PHP

generate.php

$response = file_get_contents('https://fakeusgen.netlify.app/api/generate');
$identity = json_decode($response, true);

echo "Name: " . $identity['name'];
echo "Email: " . $identity['email'];

Node.js

generate.mjs

const response = await fetch('https://fakeusgen.netlify.app/api/generate?state=NY');
const identity = await response.json();

console.log(`${identity.name} - ${identity.email}`);

Supported States

The API supports all 50 US states plus Washington D.C., Puerto Rico, and Virgin Islands. Use the 2-letter state code in the state parameter.

AL Alabama

AK Alaska

AZ Arizona

AR Arkansas

CA California

CO Colorado

CT Connecticut

DE Delaware

FL Florida

GA Georgia

HI Hawaii

ID Idaho

IL Illinois

IN Indiana

IA Iowa

KS Kansas

KY Kentucky

LA Louisiana

ME Maine

MD Maryland

MA Massachusetts

MI Michigan

MN Minnesota

MS Mississippi

MO Missouri

MT Montana

NE Nebraska

NV Nevada

NH New Hampshire

NJ New Jersey

NM New Mexico

NY New York

NC North Carolina

ND North Dakota

OH Ohio

OK Oklahoma

OR Oregon

PA Pennsylvania

RI Rhode Island

SC South Carolina

SD South Dakota

TN Tennessee

TX Texas

UT Utah

VT Vermont

VA Virginia

WA Washington

WV West Virginia

WI Wisconsin

WY Wyoming

DC Washington D.C.

PR Puerto Rico

Limits

10s

Max execution time

Max identities per request

200

Max addresses per page

Data Fields

Each generated identity includes the following fields:

Field	Type	Description
`name`	string	Full name (first + last)
`gender`	string	Male or Female
`date_of_birth`	string	MM/DD/YYYY format
`age`	number	Age in years (18-72)
`blood_type`	string	Blood type (A+, A-, B+, etc.)
`height`	string	Height in feet/inches and cm
`weight`	string	Weight in lbs and kg
`address.street`	string	Street address line 1
`address.street2`	string	Street address line 2 (may be empty)
`address.city`	string	City name
`address.state`	string	Full state name
`address.state_abbr`	string	2-letter state code
`address.zip`	string	ZIP code
`phone`	string	Phone number (XXX) XXX-XXXX
`email`	string	Email address
`username`	string	Username
`password`	string	Random password
`ip_address`	string	IPv4 address
`mac_address`	string	MAC address
`employment.occupation`	string	Job title
`employment.company`	string	Company name
`employment.salary`	string	Annual salary
`credit_card.brand`	string	Visa, Mastercard, Amex, etc.
`credit_card.number`	string	Luhn-valid test card number
`credit_card.expiry`	string	MM/YYYY format
`credit_card.cvv`	string	3 or 4 digit CVV
`ssn`	string	XXX-XX-XXXX format (TEST DATA)

FAQ

Is the API really free?

Yes. The FakeUSGen API is 100% free. No API key required, no credit card, no signup. Just call the endpoint and get data.

Is there an API key?

No. Just make a GET request to the endpoint. No authentication needed.

Can I use this in production?

The API is designed for testing and development. For production apps that need reliable fake data, consider using a dedicated fake data service.

Is the generated data real?

No. All data is randomly generated and fictional. Credit card numbers are Luhn-valid but are test data only. SSNs are structurally valid but fake.

Can I use CORS from my website?

Yes. The API includes Access-Control-Allow-Origin: * headers, so you can call it from any website or application.