Feature film facts (Wikidata) API

Resolve a film by title and return structured facts from the Wikidata knowledge graph: director(s), principal cast, release year, genres, countries, box office, budget, runtime and IMDb id, deduped across graph rows (Wikidata). Answers 'who directed The Matrix', 'box office of Inception', 'what year did Titanic come out'.

Price$0.01per request

MethodPOST

Route/v1/data/screen-movie-facts

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

datafilmmoviewikidatadirectorbox-officecinemascreen

API URLhttps://x402.hexl.dev/v1/data/screen-movie-facts

Integration docs

Example request

{
  "title": "The Matrix"
}

Example response

{
  "query": "The Matrix",
  "found": true,
  "wikidataId": "Q83495",
  "wikidataUrl": "https://www.wikidata.org/wiki/Q83495",
  "film": {
    "title": "The Matrix",
    "description": "1999 film by the Wachowskis",
    "year": 1999,
    "directors": [
      "Lana Wachowski",
      "Lilly Wachowski"
    ],
    "cast": [
      "Keanu Reeves",
      "Laurence Fishburne",
      "Carrie-Anne Moss"
    ],
    "genres": [
      "science fiction film",
      "action film"
    ],
    "countries": [
      "United States"
    ],
    "boxOfficeUsd": 463517383,
    "budgetUsd": 63000000,
    "runtimeMinutes": 136,
    "imdbId": "tt0133093"
  }
}

Input schema

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "examples": [
        "The Matrix"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}