apyhub
DATA VALIDATION · SMART GENERATION

Generate Fake Address API

What it does

Fake Address Generator returns plain-string street addresses for testing, demos, and data seeding. Send an optional count query parameter and get back a response with data and count.

Use it when you need realistic-looking address values without exposing customer records. It is useful for populating forms, load-testing address fields, or filling sample datasets in staging environments.

The endpoint is simple: request between 1 and 50 addresses, and receive an array of generated address strings plus the number returned. Because the output is just strings, you can drop the results into UI mockups, import scripts, or fixtures without extra parsing.

Fake Address Generator is a good fit anywhere you need placeholder address data and want to keep real addresses out of development and QA workflows.

GET
Generate fake street addresses as plain strings
http://localhost:8080/dosvak/fake-address
QUICKSTARTGUIDE

Quickstart

Fetch a small list of fake addresses by setting the count query parameter.

curl -X GET "http://localhost:8080/dosvak/fake-address?count=1" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data array of strings and a count integer.

{
  "data": ["123 Main St, Springfield"],
  "count": 1
}
TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates fake street addresses and returns them as plain strings in a JSON object. You can control how many addresses are returned with the count query parameter.

Query Parameter(s)

AttributeTypeMandatoryDescription
countIntegerNoNumber of fake street addresses to generate. Minimum: 1. Maximum: 50. Default: 1.

Response

Returns a JSON object with a data array of strings and a count integer. The data field contains the generated fake street addresses, and count indicates how many were returned.

AttributeTypeMandatoryDescription
dataString ArrayYesArray of generated fake street address strings.
countIntegerYesNumber of addresses returned.

Query parameters

Name
Type
Description
countOPTIONAL
integer
DEFAULT 1
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.