# Mock Data API > Generate realistic fake data — users, postal addresses, companies and products — for testing, prototyping, demos and database seeding. Localizable to many languages and regions for names, addresses and phone numbers. Server-side and deterministic to call, ideal for CI fixtures and frontend mock states. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/mockdata-api/..." ``` ## Pricing - **Free** (Free) — 12,000 calls/Mo, 3 req/s - **Basic** ($4/Mo) — 150,000 calls/Mo, 10 req/s - **Pro** ($15/Mo) — 750,000 calls/Mo, 30 req/s - **Mega** ($39/Mo) — 4,000,000 calls/Mo, 80 req/s ## Endpoints ### Mock Data #### `GET /v1/addresses` — Fake postal addresses **Parameters:** - `count` (query, optional, string) — How many to generate, 1-100 Example: `5` - `locale` (query, optional, string) — Faker locale (de, fr, es, en_US …) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mockdata-api/v1/addresses?count=5" ``` **Response:** ```json { "data": { "count": 5, "results": [ { "zip": "81791-9600", "city": "Eddiefield", "state": "Georgia", "street": "7419 Alf Radial", "country": "Republic of Korea", "latitude": -40.7032, "timezone": "Atlantic/Cape_Verde", "longitude": -0.3393, "secondary": "Apt. 205", "country_code": "GS" }, { "zip": "21757-2081", "city": "Stiedemannview", "state": "Colorado", "street": "90379 MacGyver Mews", "country": "Guernsey", "latitude": 56.7737, "timezone": "Africa/Banjul", "longitude": 14.9099, "secondary": "Suite 215", "country_code": "MV" }, { "zip": "92607", "city": "Brandon", "state": "Kansas", "street": "6124 Noelia Throughway", "country": "Sudan", "latitude": -75.7492, "timezone": "America/Lower_Princes", "longitude": -93.754, "secondary": "Apt. 231", "country_code": "VI" }, { "zip": "13020", "city": "Fort Ola", "state": "South Carolina", "stree …(truncated, see openapi.json for full schema) ``` #### `GET /v1/companies` — Fake companies **Parameters:** - `count` (query, optional, string) — How many to generate, 1-100 Example: `5` - `locale` (query, optional, string) — Faker locale (de, fr, es, en_US …) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mockdata-api/v1/companies?count=5" ``` **Response:** ```json { "data": { "count": 5, "results": [ { "url": "https://youthful-produce.com/", "buzz": "disintermediate best-of-breed content", "name": "Gutmann, Schneider and O'Kon", "email": "danielle.wintheiser29@yahoo.com", "phone": "1-344-795-4196 x49249", "address": { "city": "Fort Madisynchester", "country": "Palau" }, "industry": "Garden", "catchphrase": "Stand-alone transitional hub" }, { "url": "https://snoopy-zebra.org/", "buzz": "repurpose B2B solutions", "name": "Rodriguez - Jacobson", "email": "elaina_robel23@gmail.com", "phone": "329-252-7804 x1831", "address": { "city": "Conway", "country": "Comoros" }, "industry": "Home", "catchphrase": "Horizontal fault-tolerant intranet" }, { "url": "https://artistic-intellect.name/", "buzz": "grow cross-platform large language models", "name": "Moen LLC", "email": "laurie_kuhic70@gmail.com", "phone": "1-940-453-0338 x451", "address": { "city": "North Amie", "country …(truncated, see openapi.json for full schema) ``` #### `GET /v1/products` — Fake products **Parameters:** - `count` (query, optional, string) — How many to generate, 1-100 Example: `5` - `locale` (query, optional, string) — Faker locale (de, fr, es, en_US …) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mockdata-api/v1/products?count=5" ``` **Response:** ```json { "data": { "count": 5, "results": [ { "id": "7a31868f-1e19-4b16-953e-6c523cfefa0e", "sku": "DA09AUV0US", "name": "Ergonomic Wooden Computer", "price": 638.89, "currency": "USD", "in_stock": true, "material": "Bronze", "department": "Automotive", "description": "Featuring Protactinium-enhanced technology, our Bacon offers unparalleled tame performance" }, { "id": "1db4dfad-4995-4610-abfa-ab10e06901bd", "sku": "LZO48XKHHF", "name": "Luxurious Granite Tuna", "price": 350.39, "currency": "USD", "in_stock": true, "material": "Metal", "department": "Grocery", "description": "New Car model with 18 GB RAM, 984 GB storage, and acclaimed features" }, { "id": "552da019-a513-4ac1-aab0-12923d0f54ee", "sku": "B418DAWX2S", "name": "Rustic Silk Car", "price": 883.29, "currency": "USD", "in_stock": false, "material": "Ceramic", "department": "Kids", "description": "The Kayli Bike is the latest in a series of other products from Cremin - MacGyver" }, { …(truncated, see openapi.json for full schema) ``` #### `GET /v1/users` — Fake user profiles **Parameters:** - `count` (query, optional, string) — How many to generate, 1-100 Example: `5` - `locale` (query, optional, string) — Faker locale (de, fr, es, en_US …) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/mockdata-api/v1/users?count=5" ``` **Response:** ```json { "data": { "count": 5, "results": [ { "id": "f969ca74-ef17-46f9-8557-7680a20365f0", "email": "sabrina.bauch64@yahoo.com", "phone": "722.622.6135 x5231", "avatar": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/85.jpg", "gender": "female", "address": { "zip": "92554", "city": "Anchorage", "state": "Tennessee", "street": "373 E Central Avenue", "country": "Turkey" }, "username": "Sabrina.Bauch32", "birthdate": "1964-06-23", "full_name": "Sabrina Bauch", "job_title": "Regional Interactions Producer", "last_name": "Bauch", "first_name": "Sabrina" }, { "id": "8d7ff7ff-63f8-41ed-8be3-a124fcee7585", "email": "timmy.mcdermott37@hotmail.com", "phone": "1-716-261-4126 x12039", "avatar": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/90.jpg", "gender": "male", "address": { "zip": "31618-2031", "city": "East Alexiestead", "state": "Kansas", "street": "296 Howard Road", "country": "Eritrea" …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/mockdata-api OpenAPI spec: https://www.oanor.com/api/mockdata-api/openapi.json