FindPornFace.com public API

More than 25k porn stars, adult models and supermodels, fast search with filters, searching actresses and models by photo engine — all of these cool features will be able to you with FindPornFace API.
Our team updates database every week. We add photos, new porn stars, adult models and so on.
Stay tuned ;)

API documentation

You can get info about endpoints and reponse entites. You can try to make several requests on Mashape.com.

Endpoints

Search by photo

Response code
Description
200
data:
    actors: Actress[]
    results: SearchByPhotoResultsItem[]
    uploaded_face_params: UploadedFaceParams
4xx
error: Error
50x
error: Error

Search by query

Response code
Description
200
4xx
error: Error
50x
error: Error

Actors list

Response code
Description
200
4xx
error: Error
50x
error: Error

Actor profile

Response code
Description
200
data: Actress
4xx
error: Error
50x
error: Error

Suggests

Response code
Description
200
data: Suggest[]
4xx
error: Error
50x
error: Error

Entites

Actress

Field name
Type
Description
id
string
UUID of an actress
name
string
Name of an actress. This param is not unique for each actress, cause we have some actresses in our database, who has the same name.
nick_names
string[]
Array of nickNames
gender
string
mail | female
ethnicity
string
An ethnicity of actress
profession
string
Actress profession
country
string
Country of origin
day_of_birth
number | null
A day of birth
month_of_birth
string | null
A month of birth
year_of_birth
number | null
An year of birth
career_status
string
Career status. Can be equal to "unknown"
career_start
number | null
Year of career start. Can be null
career_end
number | null
Year of career end
cup_size
string | null
CupSize or bra size. Used to measure bust size by the letters of the alphabet.
bust_size
number | null
Size of the bust
waist_size
number | null
Size of the waist
hip_size
number | null
Size of the hip
has_fake_boobs
boolean | null
Does actress have fake boobs. Null means, that we do not have exact info
height
number | null
Height of an actress
weight
number | null
Weight of an actress
eyes_color
string | null
Eyes color of an actress
hair_color
string | null
Hair color of an actress
piercings
string | null
Piercings of an actress
tattoos
string | null
Tattoos of an actress
additional_info
string
Any additional info about actress. Can have html-etities and html-tags.
photos
Photos
social_links
Links to social network profiles of an actress.

PhotoItem

Field name
Type
Description
preview
string
Link to preview photo
full
string
Link to full photo
source_id
string
Source of the photo

Suggest

Field name
Type
Description
id
string
UUID of an actress
name
string
Name of an actress. This param is not unique for each actress, cause we have some actresses in our database, who has the same name.
nick_names
string[]
Array of nickNames

Search by photo results item (SearchByPhotoResultsItem)

Field name
Type
Description
actor_id
string
UUID of an actress
actor_photo
PhotoItem for current result
confidence
float
How much woman from photo equals to current actress

UploadedFaceParams

Field name
Type
Description
Height
float
Height of the bounding box as a ratio of the overall image height
Width
float
Width of the bounding box as a ratio of the overall image width
Left
float
Left coordinate of the bounding box as a ratio of overall image width
Top
float
Top coordinate of the bounding box as a ratio of overall image height

Search meta (Meta)

Field name
Type
Description
limit
number
Number of actresses per page
page
number
Current page number
pages_count
number
Count of pages
total_count
number
Total count of actresses
links
Links to prev, next, first and last pages

Error

Field name
Type
Description
code
number
Error code
message
string
Error description