TMDB API endpoint
Returns a TMDB person by `id`: name, biography, birth date, photo URL and a filmography of movie and TV credits, most prominent first. `limit` caps the credits (default 10, max 20). Each credit has its `type` (`movie` or `tv`), id, title and `uri`. The biography may include a Wikipedia CC-BY-SA attribution note.
/tmdb/person/{id}Path parameters:
id (required) — TMDB person id.Query parameters:
limit (optional, default 10, max 20).Response includes biography (may include a Wikipedia CC-BY-SA attribution note, passed through as TMDB itself displays it), birth_date, photo_url, filmography[] (type is movie or tv; use id with GET /tmdb/movie/{id} or GET /tmdb/tv/{id} for full detail).
| Field | Filled in, of 8 checked | Values in the sample |
|---|---|---|
| type | 8 | |
| id | 8 | |
| title | 8 | |
| uri | 8 | themoviedb.org |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | TMDB person id | 31 | |
| limit | integer | No | Max filmography credits, default 10, max 20 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/tmdb/person/31?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "31",
"name": "Tom Hanks",
"biography": "Thomas Jeffrey Hanks (born July 9, 1956) is an American actor and filmmaker...",
"birth_date": "1956-07-09",
"photo_url": "https://image.tmdb.org/t/p/w500/oFvZoKI6lvU03n4YoNGAll9rkas.jpg",
"filmography": [
{
"type": "movie",
"id": "13",
"title": "Forrest Gump",
"uri": "https://www.themoviedb.org/movie/13-forrest-gump"
},
{
"type": "movie",
"id": "862",
"title": "Toy Story",
"uri": "https://www.themoviedb.org/movie/862-toy-story"
}
],
"uri": "https://www.themoviedb.org/person/31-tom-hanks",
"source_url": "https://www.themoviedb.org/person/31"
}
}Request schema
No body schema
Response schema
#/definitions/tmdb.personResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | tmdb.PersonResponse | No | ||||
| data.biography | string | No | ||||
| data.birth_date | string | No | 1956-07-09 | |||
| data.filmography | array | No | ||||
| data.filmography[].id | string | No | ||||
| data.filmography[].title | string | No | ||||
| data.filmography[].type | string | No | movie | |||
| data.filmography[].uri | string | No | ||||
| data.id | string | No | 31 | |||
| data.name | string | No | Tom Hanks | |||
| data.photo_url | string | No | ||||
| data.source_url | string | No | ||||
| data.uri | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/tmdb/person/31?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"