IAFD APIiafd.com ↗
Access IAFD performer bios, filmographies, awards, movie cast lists, and trending performers via a structured REST API with 7 endpoints.
What is the IAFD API?
The IAFD API provides structured access to the Internet Adult Film Database across 7 endpoints, covering performer biographies, full filmographies, award histories, and movie metadata including cast lists. The get_performer_details endpoint returns fields like birthday, birthplace, ethnicity, height, weight, and years active, while get_movie_details returns director, studio, runtime, release date, and a full performer roster for any given title.
curl -X GET 'https://api.parse.bot/scraper/c71e1711-c72e-4d9a-aed5-37abe2370682/search?query=Sasha+Grey' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace iafd-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.iafd_internet_adult_film_database_api import IAFD, PerformerSummary, Performer, Movie, Credit, Award
iafd = IAFD(api_key="YOUR_API_KEY")
# Search for performers by name
for result in iafd.performersummaries.search(query="Sasha Grey"):
print(result.name, result.aka, result.url)
# Get full biographical details for a performer
detail = iafd.performers.get(id="054f5d3f-9395-45ce-a550-558896fb2107")
print(detail.name, detail.bio.birthday, detail.vital_stats.height)
# Navigate from a search result to full details
p = iafd.performersummary(id="054f5d3f-9395-45ce-a550-558896fb2107")
full = p.details()
print(full.name, full.bio.birthplace, full.vital_stats.ethnicity)
# List a performer's filmography
for credit in p.credits.list():
print(credit.title, credit.year, credit.distributor)
# List a performer's awards
for award in p.awards.list():
print(award.organization, award.status, award.raw_text)
# Get trending performers
for top in iafd.performersummaries.top():
print(top.name, top.id)
# Get performers born today
for birthday in iafd.performersummaries.born_today():
print(birthday.name, birthday.url)
# Get movie details with cast
movie = iafd.movies.get(id="707e327c-64e2-42d7-8e4b-4f01f4a6213a")
print(movie.title, movie.info.director, movie.info.release_date)
for cast_member in movie.performers:
print(cast_member.name, cast_member.url)
Full-text search across performers and movies on IAFD. The query matches performer names (including aliases) and movie titles. Returns two arrays: performers with photo and alias info, and movies with year and distributor. No pagination — all matches are returned in a single response.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (performer name or movie title) |
{
"type": "object",
"fields": {
"movies": "array of movie objects with title, id, url, year, and distributor fields",
"performers": "array of performer objects with name, id, url, photo, and aka fields"
},
"sample": {
"data": {
"movies": [
{
"id": "707e327c-64e2-42d7-8e4b-4f01f4a6213a",
"url": "https://www.iafd.com/title.rme/id=707e327c-64e2-42d7-8e4b-4f01f4a6213a",
"year": "2006",
"title": "2952 Hillary Scott and Sasha Grey Strip Tease",
"distributor": "suze.net"
}
],
"performers": [
{
"id": "054f5d3f-9395-45ce-a550-558896fb2107",
"aka": "Sasha Gray, Sascha Grey, Sacha Grey",
"url": "https://www.iafd.com/person.rme/id=054f5d3f-9395-45ce-a550-558896fb2107",
"name": "Sasha Grey",
"photo": "https://www.iafd.com/graphics/headshots/sashagrey_f_0525.jpg"
}
]
},
"status": "success"
}
}About the IAFD API
Performer Data
The search endpoint accepts a query string and returns two arrays: performers (with name, id, url, photo, and aka fields) and movies (with title, id, url, year, and distributor). Use the returned id values as inputs to the detail endpoints. get_performer_details returns a bio object (birthday, birthplace, gender, years_active) and a vital_stats object (ethnicity, height, weight, measurements) alongside the performer's name and headshot URL.
Filmography and Awards
get_performer_credits returns an array of credit objects for a given performer UUID, each including title, year, distributor, url, and a notes field that captures role or scene-level annotations. get_performer_awards returns an awards array with organization name, year, award status (Winner or Nominee), associated movie title, and a raw_text field for the full award string as it appears on IAFD.
Movie Details and Discovery
get_movie_details accepts a movie UUID from search results or performer credits and returns an info object covering director, studio, distributor, runtime in minutes, and release date, plus a performers array listing all billed cast members with their IDs and profile URLs. For discovery, get_top_performers returns a ranked list of top actresses by page views pulled from the IAFD homepage, and get_born_today returns performers whose birthday matches the current calendar date.
The IAFD API is a managed, monitored endpoint for iafd.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when iafd.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official iafd.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a performer profile page that combines bio fields from
get_performer_detailswith a chronological credit list fromget_performer_credits - Populate an awards tracker that filters
get_performer_awardsresults by organization or status (Winner vs. Nominee) - Construct a movie detail page showing director, studio, runtime, and full cast using
get_movie_details - Power a 'born today' widget for a fan or editorial site using
get_born_today - Build a trending performers leaderboard ranked by page-view data from
get_top_performers - Cross-reference performer filmographies with movie metadata to map co-star relationships across titles
- Index performer aliases (the
akafield from search) to resolve alternative stage name searches
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does IAFD have an official developer API?+
What does `get_performer_awards` return and how is status distinguished?+
awards array includes the organization name, year, a status field that is either 'Winner' or 'Nominee', the associated movie title, and a raw_text field containing the full award string as it appears on IAFD. There is no additional filter parameter — you receive all recorded awards and nominations for the performer in a single call.Does `get_top_performers` return both male and female performers?+
top_actresses array. Male performers are not included in the current response shape. You can fork this API on Parse and revise it to add a top actors endpoint if you need rankings across genders.