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.1.0
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
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:
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.
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.
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
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 | 1 |
buildingNumber | "449" |
card_expiration | "08\/23" |
card_number | "4716097277627561" |
card_type | "Visa" |
city | "Millerville" |
company_name | "Cummerata LLC" |
counter | 5 |
country | "United States of America" |
countryCode | "GH" |
date | "2006-03-10" |
dateTime | {"date":"1974-01-21 04:00:36.000000","timezone_type":3,"timezone":"UTC"} |
ean | "6158642122421" |
"grady.roma@hotmail.com" | |
firstName | "Meaghan" |
image | "http:\/\/placeimg.com\/640\/480\/any" |
lastName | "Dicki" |
latitude | -36.492193 |
longText | "I should frighten them out with trying, the poor little feet, I wonder if I must, I must,' the King added in a large mushroom growing near her, she began, rather timidly, as she tucked her arm affectionately into Alice's, and they can't prove I did: there's no room to grow up again! Let me see: that would be QUITE as much use in the middle, nursing a baby; the cook was busily stirring the soup, and seemed not to be two people. 'But it's no use going back to finish his story. CHAPTER IV. The Rabbit Sends in a deep, hollow tone: 'sit down, both of you, and must know better'; and this was his first remark, 'It was a general chorus of 'There goes Bill!' then the Mock Turtle went on in the distance, screaming with passion. She had already heard her sentence three of her sister, who was gently brushing away some dead leaves that had fluttered down from the roof. There were doors all round the thistle again; then the different branches of Arithmetic--Ambition, Distraction, Uglification, and." |
longitude | 48.274046 |
name | "Alexane Gislason" |
null | null |
number | 8856019 |
phone | "+8802602704720" |
pokemon | "Goldeen" |
postcode | "63386" |
state | "Arizona" |
streetAddress | "697 Ora Squares Apt. 183" |
streetName | "Hudson Mills" |
text | "The Dormouse slowly opened his eyes. He looked at the mushroom for a few minutes it seemed quite dull and stupid for life to go down the bottle, saying to herself, 'Now, what am I then? Tell me that." |
upc | "795535318663" |
uuid | "62c22b96-3596-33c8-9728-b05002039399" |
vat | "955939633" |
website | "hermiston.com" |
word | "dolores" |
Custom request:
https://fakerapi.it/api/v1/custom?_quantity=1&customfield1=name&customfield2=dateTime&customfield3=phone
Response:
Test Response.
Date of release: 13 March 2021
Date of release: 23 April 2020
Date of release: 14 April 2020
Date of release: 12 April 2020