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 "_locale" parameter and also allows to select the number of rows requested by "_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.0.2

Docs

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.

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

Base URL #

https://fakerapi.it/api/v1/{resource}

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/v1/images?_width=380

Data are always wrapped inside "data" and are always returned with the total number of rows ("total") and with the Http response "code".

Every resource accepts 3 GET common 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:

https://fakerapi.it/api/v1/persons?_locale=fr_FR

This example returns people with french names.

_quantity #

Default: 10

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/v1/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 number (ex. 12345) the results will never change. Example:

https://fakerapi.it/api/v1/companies?_seed=12456

Resources #

Request:

https://fakerapi.it/api/v1/addresses?_quantity=1

Response:

Request:

https://fakerapi.it/api/v1/books?_quantity=1

Response:

Request:

https://fakerapi.it/api/v1/companies?_quantity=1

Response:

Request:

https://fakerapi.it/api/v1/credit_cards?_quantity=1

Response:

Additional optional parameters:

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

Request:

https://fakerapi.it/api/v1/images?_quantity=1&_type=kittens&_height=300

Response:

Additional optional parameters:

Parameter Description Example
_gender male, female
_gender=female
_birthday_start date in format Y-m-d (default: -90 years)
_birthday_start=1994-02-09
_birthday_end date in format Y-m-d (default: now)
_birthday_end=2018-10-09

Request:

https://fakerapi.it/api/v1/persons?_quantity=1&_gender=male&_birthday_start=2005-01-01

Response:

Request:

https://fakerapi.it/api/v1/places?_quantity=1

Response:

Additional optional parameters:

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

Request:

https://fakerapi.it/api/v1/products?_quantity=1&_taxes=12&_categories_type=uuid

Response:

Additional optional parameters:

Parameter Description Example
_characters integer (default: 200)
_characters=350

Request:

https://fakerapi.it/api/v1/texts?_quantity=1&_characters=500

Response:

Additional optional parameters:

Parameter Description Example
_gender male, female
_gender=female

Request:

https://fakerapi.it/api/v1/users?_quantity=1&_gender=male

Response:

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:

myCustomName1=customType1&myCustomName2=customType2

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 "686"
card_expiration "12\/21"
card_number "4556937720575490"
card_type "MasterCard"
city "Lake Libby"
company_name "Feeney-Kohler"
counter 7
country "Lesotho"
countryCode "SY"
date "1988-04-11"
dateTime {"date":"1994-04-25 06:50:40.000000","timezone_type":3,"timezone":"UTC"}
ean "1032827490558"
email "jamel.predovic@boehm.com"
firstName "Shany"
image "http:\/\/placeimg.com\/640\/480\/any"
lastName "Ortiz"
latitude -35.807544
longText "Dormouse began in a louder tone. 'ARE you to leave it behind?' She said the Hatter grumbled: 'you shouldn't have put it to be an advantage,' said Alice, (she had grown up,' she said to herself that perhaps it was only sobbing,' she thought, 'till its ears have come, or at any rate,' said Alice: 'besides, that's not a regular rule: you invented it just grazed his nose, and broke off a little now and then Alice put down the chimney!' 'Oh! So Bill's got to go near the entrance of the March Hare: she thought it over here,' said the Duck: 'it's generally a ridge or furrow in the sea, 'and in that poky little house, and have next to her. The Cat seemed to rise like a telescope.' And so she began fancying the sort of way, 'Do cats eat bats?' and sometimes, 'Do bats eat cats?' for, you see, as they lay on the twelfth?' Alice went on eagerly. 'That's enough about lessons,' the Gryphon answered, very nearly getting up and repeat something now. Tell her to wink with one finger, as he came, 'Oh!."
longitude 124.555765
name "Jedidiah Greenfelder"
null null
number 795
phone "+2852720093804"
pokemon "Magmortar"
postcode "22951-8755"
state "Arkansas"
streetAddress "62911 Candelario Stravenue"
streetName "Sidney Roads"
text "Pennyworth only of beautiful Soup? Beau--ootiful Soo--oop! Soo--oop of the wood--(she considered him to be lost: away went Alice after it, 'Mouse dear! Do come back in a whisper, half afraid that."
upc "883656011934"
uuid "d3210587-8d1a-3a92-a604-8a16ad8f58e0"
vat "6343127733"
website "parker.com"
word "accusamus"

Custom request:

https://fakerapi.it/api/v1/custom?_quantity=1&customfield1=name&customfield2=dateTime&customfield3=phone

Response:

Test APIs

Test Response.

Changelogs

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