NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Filmography API

GET

Get a person's films by name: actor, director, writer, producer, composer and more.

Filmography returns the films a person worked on, newest first, from their name or Wikidata id: each film's title, year and the person's roles in it, such as director and writer. Filter by role to get only the films someone directed or acted in. When several people share a name, the best-known comes first and the others are listed with a film they are known for. Covers the cast and crew of about 450,000 films.

Try it — live request, no key required

Request
GETapi.apiverve.com/v1/filmography?name=Christopher%20Nolan
Query parameters
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "name": "Christopher Nolan",
    "id": "Q25191",
    "role": "any",
    "count": 10,
    "filmsTotal": 21,
    "roles": {
      "director": 17,
      "writer": 15,
      "producer": 13,
      "actor": 3,
      "cinematographer": 3,
      "editor": 1
    },
    "films": [
      {
        "title": "The Odyssey",
        "year": 2026,
        "roles": [
          "director",
          "writer",
          "producer"
        ],
        "id": "Q131547207"
      },
      {
        "title": "Oppenheimer",
        "year": 2023,
        "roles": [
          "director",
          "writer",
          "producer"
        ],
        "id": "Q108839994"
      },
      {
        "title": "Tenet",
        "year": 2020,
        "roles": [
          "director",
          "writer",
          "producer"
        ],
        "id": "Q63985561"
      },
      {
        "title": "Dunkirk",
        "year": 2017,
        "roles": [
          "director",
          "writer",
          "producer"
        ],
        "id": "Q21935651"
      },
      {
        "title": "Behind the Scenes",
        "year": 2017,
        "roles": [
          "actor"
        ],
        "id": "Q108257926"
      },
      {
        "title": "Quay",
        "year": 2015,
        "roles": [
          "director"
        ],
        "id": "Q21869743"
      },
      {
        "title": "Interstellar",
        "year": 2014,
        "roles": [
          "director",
          "writer",
          "producer"
        ],
        "id": "Q13417189"
      },
      {
        "title": "Transcendence",
        "year": 2014,
        "roles": [
          "producer"
        ],
        "id": "Q10384115"
      },
      {
        "title": "Man of Steel",
        "year": 2013,
        "roles": [
          "writer",
          "producer"
        ],
        "id": "Q622769"
      },
      {
        "title": "The Dark Knight Rises",
        "year": 2012,
        "roles": [
          "director",
          "writer",
          "producer"
        ],
        "id": "Q189330"
      }
    ],
    "otherMatches": [],
    "dataAsOf": "2026-11-22"
  }
}

About the Filmography API

A filmography API for apps that browse movies by people: actor pages, director retrospectives, six-degrees games, trivia and recommendation engines that follow a favourite actor. Search by name in any case, with or without accents, or look up exactly by Wikidata id.

Every plan gets the person's name and id, the number of films on record and up to 10 films, newest first, each with its title, year, the person's roles in it and the film's Wikidata id, which Movie Lookup accepts for the full film record. A role filter narrows to director, actor, writer, producer, composer, cinematographer or editor. Paid plans return up to 50 films and a count of films per role. When a name is shared, otherMatches lists up to five other people with a film each is known for, so you can retry with their id.

Data is refreshed monthly from the same catalog as Movie Lookup.

How it works

Pass name or id. A name search ignores case, accents and punctuation; when several people share the name, the best-known (by worldwide encyclopedia coverage) is returned and up to five others appear in otherMatches with a film they are known for. No match returns 404.

Films come newest first; films without a recorded year come last. roles lists every role the person had on that film, so a writer-director shows both. role filters to one role, and filmsTotal counts the films matching it. Each film's id is its Wikidata id, which Movie Lookup accepts as id for the full record.

Credits come from Wikidata (CC0) and are refreshed monthly with Movie Lookup.

What people use it for

Actor and Director Pages
Build person pages that list every film someone made, newest first, with their role in each.
Movie Discovery
Let users jump from a film to everything else its director or lead actor worked on.
Trivia and Connection Games
Power six-degrees and who-directed-what games from credits across 450,000 films.
Recommendation Engines
Recommend films by following the people behind a viewer's favourites.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Filmography

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Filmography API.

Read the docs →
Which people are covered?
Everyone credited as director, cast, screenwriter, producer, composer, director of photography or editor on any of about 450,000 films. Well-known people have full filmographies; for lesser-known films the credits on record may be incomplete.
What does the Free plan return?
The Free plan returns the person's name and id, the number of films on record, up to 10 films newest first with their roles, the role filter and other people with the same name. Up to 50 films per call and the count of films per role require a paid plan.
What if two people share a name?
The best-known person comes first. otherMatches lists up to five others with the same name, each with a film they are known for and their Wikidata id; pass that id to get their filmography instead.
Which plan fits 50,000 lookups a month?
Starter covers it. At 1 credit per call, 50,000 lookups use 50,000 credits, or a quarter of the 200,000 credits on Starter. That works out to about $0.15 per 1,000 calls. The Free plan includes 200 calls per month.
Where does the data come from?
Credits come from Wikidata, the open knowledge base behind Wikipedia, and are refreshed monthly. Each film carries its Wikidata id, so you can fetch the full record from Movie Lookup.

Ready to build with Filmography? Start with 200 free credits — one key unlocks all 406+ APIs.

Explore the catalog

406+ APIs on the same key and the same response shape.

Browse all APIs