What's Faker API?

Faker API it's a collection of completely free APIs that helps web developers and web designers generate fake data in a fast and easy way. No registration is required. No tokens, no authentication.

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.

Check the Docs to read more about every resource. In addition, it's available the Postman collection to use these APIs directly in the well-known client.

At the end of this page you will find the Test section, where you can test our APIs throug the specific form.

Current version: 1.1.1


No registration is required. No tokens, no keys or other types of authentication. Faker API it's a free service for every developer who want to use it.

Download here the Postman collection (v 2.1)
Download Postman Collection

Base URL #


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:


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 #

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:


This example returns people with french names.

_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:


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:


Resources #













Additional optional parameters:

Parameter Description Example
_type any, animals, architecture, nature, people, tech, kittens, pokemon
_width pixels (default: 640)
_height pixels (default: 480)




Additional optional parameters:

Parameter Description Example
_gender male, female
_birthday_start date in format Y-m-d (default: -90 years)
_birthday_end date in format Y-m-d (default: now)







Additional optional parameters:

Parameter Description Example
_price_min number in format 10.35 (default: 0.01)
_price_max number in format 10.35 (default: none)
_taxes percentage (default: 22)
_categories_type integer, string, uuid (default: integer)




Additional optional parameters:

Parameter Description Example
_characters integer (default: 200)




Additional optional parameters:

Parameter Description Example
_gender male, female




This resource is the only one which does'nt follow the same rules of the others.
The 3 common parameters (_quantity, _locale, _seed) have the same usage of the other resources, but this request it's managed in a different way.

Request to this resource accepts custom parameters following this pattern:


where myCustomName1 and myCustomName2 are my custom parameters names, and customType1 and customType2 are my custom parameters types. See below the allowed types.

This allows to generate a custom ad hoc resource, using type parameters listed below:

Parameter Example
boolean true
boolean_digit 0
buildingNumber "3798"
building_number "See 'buildingNumber'"
card_expiration "04\/24"
card_number "6011119217799123"
card_type "MasterCard"
city "North Deangelo"
company_name "Emmerich, Veum and Wunsch"
counter 5
country "Montenegro"
countryCode "FM"
country_code "See 'countryCode'"
date "2016-11-26"
dateTime {"date":"2001-07-09 12:01:46.000000","timezone_type":3,"timezone":"UTC"}
date_time "See 'dateTime'"
ean "6046890659038"
email "stiedemann.jadyn@wiegand.net"
firstName "Opal"
first_name "See 'firstName'"
image "http:\/\/placeimg.com\/640\/480\/any"
lastName "Schinner"
last_name "See 'lastName'"
latitude -0.65592
longText "Come and help me out of sight. Alice remained looking thoughtfully at the sides of it; then Alice put down her flamingo, and began singing in its sleep 'Twinkle, twinkle, twinkle, twinkle--' and went on: '--that begins with a shiver. 'I beg your acceptance of this elegant thimble'; and, when it had a little glass table. 'Now, I'll manage better this time,' she said, 'for her hair goes in such a curious dream, dear, certainly: but now run in to your places!' shouted the Queen was silent. The King and the others all joined in chorus, 'Yes, please do!' but the Hatter was the same year for such a long way. So she sat on, with closed eyes, and half believed herself in the face. 'I'll put a stop to this,' she said this, she noticed that one of the guinea-pigs cheered, and was delighted to find her in an offended tone, 'was, that the Gryphon remarked: 'because they lessen from day to such stuff? Be off, or I'll kick you down stairs!' 'That is not said right,' said the Mock Turtle yet?'."
long_text "See 'longText'"
longitude -170.292481
name "Forrest Cummings"
null null
number 459110
phone "+4088155972137"
pokemon "Bouffalant"
postcode "50668"
state "Tennessee"
streetAddress "24319 Harmon Manors Suite 283"
streetName "Beatty Skyway"
street_address "See 'streetAddress'"
street_name "See 'streetName'"
text "When the pie was all ridges and furrows; the balls were live hedgehogs, the mallets live flamingoes, and the turtles all advance! They are waiting on the English coast you find a thing,' said the."
upc "828022010645"
uuid "ce9e7d63-21a9-39e0-ad5f-11d0ec7c1772"
vat "5819616346"
website "kuphal.biz"
word "reiciendis"

Custom request:



Test APIs

Test Response.


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