FakerAPI

FakerAPI is a free, no-authentication REST API that returns realistic fake data for developers, designers, and QA engineers. Built on top of the PHP Faker library by Alessandro Pietrantonio, it exposes a uniform set of GET endpoints for addresses, books, companies, images, persons, places, products, texts, users, and a fully custom resource builder. Every endpoint accepts the same three control parameters (_quantity, _locale, _seed) and returns the same envelope, making it trivial to use for prototypes, mock servers, workshop fixtures, and integration tests.

1 APIs 8 Features

Test DataFake DataMockingDeveloper ToolsOpen SourcePublic APIs

No Authentication

Every endpoint is open; no API key or registration required.

60+ Locales

Generate data in en_US, fr_FR, it_IT, ja_JP, and 60+ other locales via the _locale parameter.

Deterministic Seeding

Pass _seed to make payloads exactly reproducible across runs.

Up to 1000 Records Per Call

Tune _quantity from 1 to 1000 records per request, default 10.

Custom Schema Endpoint

/api/v1/custom accepts a caller-defined field map (e.g. name=name, email=email, phone=phoneNumber) and returns matching records.

Standard Response Envelope

Every endpoint returns the same {status, code, locale, seed, total, data} shape.

Free Forever

Service is described as Free, Forever with no published rate limits.

Use Cases

Frontend Prototyping

Populate React, Vue, or Svelte mockups with realistic data without standing up a backend.

API Mocking

Use FakerAPI directly or as a fixture source for Microcks, Prism, MSW, or Postman.

QA Test Data

Generate deterministic test fixtures (via _seed) for automated browser and API tests.

Workshop and Training Fixtures

Hand learners a single URL to fetch sample data instead of provisioning per-student accounts.

Database Seeding

Seed development databases with thousands of fake users, companies, or products.

Internationalization Testing

Exercise i18n code paths with names, addresses, and phone numbers in 60+ locales.

Load Test Payload Generation

Pull large, reproducible JSON payloads to feed load generators.

Integrations

PHP Faker

FakerAPI is a thin HTTP wrapper over the venerable PHP Faker library by François Zaninotto.

Postman / Insomnia

Trivially imported as a GET-only collection.

Microcks / Prism / MSW

FakerAPI payloads work well as fixture sources for HTTP mocking tools.

Frontend Frameworks

React, Vue, Svelte, Angular, and SolidJS all fetch FakerAPI JSON directly during development.

PublicAPIsListing

Sources

opencollection: 1.0.0
info:
  name: FakerAPI
  version: 1.0.0
items:
- info:
    name: Addresses
    type: folder
  items:
  - info:
      name: List Fake Addresses
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/addresses
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
      - name: country_code
        value: ''
        type: query
        description: Restrict generated addresses to a specific ISO 3166-1 alpha-2 country code.
    docs: Return a collection of fake postal addresses with city, country, ZIP, and geocoordinates.
- info:
    name: Books
    type: folder
  items:
  - info:
      name: List Fake Books
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/books
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
    docs: Return a collection of fake book records (title, author, genre, ISBN, publisher).
- info:
    name: Companies
    type: folder
  items:
  - info:
      name: List Fake Companies
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/companies
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
    docs: Return a collection of fake company records including nested addresses.
- info:
    name: Images
    type: folder
  items:
  - info:
      name: List Fake Images
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/images
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
      - name: _type
        value: ''
        type: query
        description: Image category (people, business, nature, etc.) used in the placeholder URL.
      - name: _width
        value: ''
        type: query
        description: Placeholder image width in pixels.
      - name: _height
        value: ''
        type: query
        description: Placeholder image height in pixels.
    docs: Return a collection of fake image references with a title, description, and placeholder URL.
- info:
    name: Persons
    type: folder
  items:
  - info:
      name: List Fake Persons
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/persons
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
      - name: _gender
        value: ''
        type: query
        description: Restrict generated profiles to a single gender (`male` or `female`).
      - name: _birthday_start
        value: ''
        type: query
        description: Earliest birthday (YYYY-MM-DD) to generate.
      - name: _birthday_end
        value: ''
        type: query
        description: Latest birthday (YYYY-MM-DD) to generate.
    docs: Return a collection of fake person profiles with a nested address.
- info:
    name: Places
    type: folder
  items:
  - info:
      name: List Fake Places
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/places
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
    docs: Return a collection of fake geographic coordinates (latitude/longitude pairs).
- info:
    name: Products
    type: folder
  items:
  - info:
      name: List Fake Products
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/products
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
      - name: _categories_number
        value: ''
        type: query
        description: Number of fake categories to attach to each product.
      - name: _taxes
        value: ''
        type: query
        description: Apply a tax percentage to the generated price.
    docs: Return a collection of fake product records with nested image references.
- info:
    name: Texts
    type: folder
  items:
  - info:
      name: List Fake Texts
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/texts
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
      - name: _characters
        value: ''
        type: query
        description: Maximum number of characters in each generated text block.
    docs: Return a collection of fake titled text blocks (lorem-style content).
- info:
    name: Users
    type: folder
  items:
  - info:
      name: List Fake Users
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/users
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
      - name: _gender
        value: ''
        type: query
        description: Restrict generated accounts to a single gender (`male` or `female`).
    docs: Return a collection of fake application user accounts.
- info:
    name: Custom
    type: folder
  items:
  - info:
      name: List Fake Custom Records
      type: http
    http:
      method: GET
      url: https://fakerapi.it/api/v1/custom
      params:
      - name: _quantity
        value: ''
        type: query
        description: Number of records to return (1-1000). Default 10.
      - name: _locale
        value: ''
        type: query
        description: Locale code controlling language/region of generated data (e.g. `en_US`, `fr_FR`, `it_IT`). Default `en_US`.
      - name: _seed
        value: ''
        type: query
        description: Integer seed for deterministic, reproducible output.
    docs: 'Generate records using a caller-defined field schema. Each extra query

      parameter is treated as a field name whose value is a FakerAPI generator

      identifier (for example `name=name&email=email&phone=phoneNumber`).

      Supported generators include `name`, `firstName`, `lastName`,

      `userName`, `email`, `freeEmail`, `phoneNumber`, `password`, `md5`,

      `sha256`, `uuid`, `address`, `city`, `country`, `companyName`, `text`,

      `paragraph`, `date`, `dateTime`, `boolean`, `integer`, `randomNumber`,

      `imageUrl`, `col'
bundled: true

FakerAPI

APIs

FakerAPI

Collections

FakerAPI

Features

Use Cases

Integrations

Semantic Vocabularies

Fakerapi Context

API Governance Rules

FakerAPI API Rules

JSON Structure

Fakerapi Address Structure

Fakerapi Book Structure

Fakerapi Company Structure

Fakerapi Envelope Structure

Fakerapi Image Structure

Fakerapi Person Structure

Fakerapi Place Structure

Fakerapi Product Structure

Fakerapi Text Structure

Fakerapi User Structure

Example Payloads

Fakerapi List Addresses Example

Fakerapi List Books Example

Fakerapi List Companies Example

Fakerapi List Custom Example

Fakerapi List Images Example

Fakerapi List Persons Example

Fakerapi List Places Example

Fakerapi List Products Example

Fakerapi List Texts Example

Fakerapi List Users Example

Resources

Sources