What is Faker API?
Faker API is a collection of completely free APIs that help web developers and web designers generate mock data quickly and easily.
No registration is required. No tokens, no authentication.
It's a free-to-use tool made by developers for developers.
Docs
Every resource allows to choose the API language by the "_locale" parameter and also allows to select the number of rows requested by the "_quantity" parameter.
Max 1000 rows.
Basic usage #
Some resources allow to filter data by GET parameters.
The names of these parameters are always preceded by an underscore character "_", for example:
https://fakerapi.it/api/{version}/{resource}
Data are always wrapped inside a "data" object and are always returned with the total number of rows ("total") and with the Http response "code".
Every resource accepts 3 common GET parameters:
- _locale (string) - The language of the data returned.
- _quantity (integer) - The number of rows requested.
- _seed (integer) - A seed for the random generator.
_locale #
Default: en_US
This parameter means the language of the API response we want to get and accept the locale format "en_EN". For example:
https://fakerapi.it/api/{version}/persons?_locale=fr_FR
This example returns people with french names.
Here's a list of available locales:
_quantity #
Default: 10
Min: 1 - Max: 1000
This parameter means the number of rows we want to obtain and accept only integers. If you request more than 1000 rows (maximum) the system will return 1000 rows anyway. Example:
https://fakerapi.it/api/{version}/companies?_quantity=5
This example returns 5 companies.
_seed #
Default: null
This parameter accept an integer and allows to get always the same results. So, executing the same request with _seed parameter set to the same value (ex. 12345) the results will never change. Example:
https://fakerapi.it/api/{version}/companies?_seed=12456
Resources #
Test APIs
Date of release: 25 September 2024
- New optional param for Addresses resource: "country_code". This param allows you to force the country of the addresses returned
Date of release: 30 August 2024
- New gender for Persons resource: "other". This gender was added to support people who do not identify with binary genders
- New source (Picsum) and deletion of some types for Image resource. Now, the Image resource has only three types: "any", "pokemon"
- New parameter "_categories_number" to indicate the number of product categories to be returned in the Products resource
- New field types with related aliases for the Custom resource: "userName", "freeEmail", "companyEmail", "password", "unixTime", "timeZone", "paragraph", "sentence", "currencyCode", "domainName", "url", "tld" "ip", "macAddress", "userAgent", "iban", "isbn", "slug", "md5", "sha256", "local", "emoji", "color", "mimeType", "fileExtension", "html"...
- Updated the list of available Pokémon: there are now 897.
- New resource type: Color
- Added new automatic tests for all resources
Date of release: 08 January 2022
- New field "id" added to some resources (Persons, Users, Addresses, Companies, Products, Books)
Date of release: 30 April 2021
- Snake_case synonyms for some "custom" resources
- General fixes
Date of release: 13 March 2021
- Upgrading core technologies
Date of release: 23 April 2020
- Added "pokemon" type to Custom resource
- Added Pokémon images to Image resource
Date of release: 14 April 2020
- Added "counter" type to Custom resource
Date of release: 12 April 2020
- First release