Developer API

Generate the same realistic data you see on RandNow straight from your code, CI pipeline or no-code tool with simple HTTPS GET requests.

The public API is being prepared. The examples below show the request format; the base URL will be published here when it goes live.

Quick start

Send a GET request to /v1/{generator}. Options are passed as query parameters; anything you omit falls back to sensible defaults.

curl "https://api.randnow.com/v1/address?country=de&count=2"

{
  "generator": "address",
  "count": 2,
  "items": [
    {
      "title": "🇩🇪 Munich, Germany",
      "value": "Lindenweg 14\n80331 Munich\nGermany",
      "fields": { "Street": "Lindenweg 14", "City": "Munich", "State (Bundesland)": "Bavaria (BY)", "Postleitzahl (PLZ)": "80331", "Country": "Germany", "Phone": "+49 89 4417735" }
    }
  ]
}

Endpoints

GET /v1 lists every generator with its options and defaults. Popular endpoints:

Country codes: us gb ca au de fr it es nl ch se pl br mx in jp cn kr tr ae or random. List-style generators return value (and sometimes details); record-style generators also return a fields object.

Examples

// JavaScript
const res = await fetch("https://api.randnow.com/v1/identity?country=gb&count=5");
const { items } = await res.json();

# Python
import requests
items = requests.get("https://api.randnow.com/v1/uuid", params={"count": 10}).json()["items"]

Limits & fair use

• Up to 50 items per request (500 for UUIDs).
• Requests are rate-limited per IP to keep the service free for everyone.
• CORS is enabled, so you can call the API directly from the browser.
• Generated data is fictional — the Terms of Use apply.