CINEMATCH NEXT / MOVIE MATCHING API

Find the movie.
Connect the IDs.

Different titles. Different databases. One useful answer. Search movies by title or connect their IMDb, TMDB and Wikidata identities.

Start with free BASIC See your first request ↓

1,100 monthly requests · Batches of up to 10 · JSON responses

FILM / 001MATCHED

Inception2010

WIKIDATAQ25188

IMDbtt1375666

TMDB27205

One film. Three connected identifiers.
Verified in the current catalogue.

430,364film identities in the catalogue

3 ID systemsIMDb · TMDB · Wikidata

1–10queries in a single batch

BUILT FOR REAL CATALOGUES

Same film.
Many ways to find it.

Use CineMatch Next in import tools, catalogue reconciliation and developer workflows. Keep your own row references when processing a batch.

01 / SEARCH

Start with a title

Search a movie title or alias. Add a year or other context when you have it. Get useful candidates when a title contains a typo.

02 / CONNECT

Bring an existing ID

Send an IMDb, TMDB or Wikidata identifier and retrieve the cross-references available for that film.

03 / UNDERSTAND

Read a clear result

matched, ambiguous or not_found. Use the accepted identity when provided; review suggestions when the result is ambiguous.

MULTILINGUAL MOVIE SEARCH

A title does not need
to be in English.

These titles and identifiers were checked against the existing catalogue. Coverage varies by film and alias.

Inception

IMDb tt1375666 → Wikidata Q25188

Anatomie d'une chute

Title + 2023 → Q117037697

千と千尋の神隠し

Spirited Away · title + 2001 → Q155653

An exact title can still have more than one candidate. Similarity scores are not identity probabilities.

GETTING STARTED

Your first movie,
in one request.

Subscribe to BASIC on RapidAPI.
Use your own application's consumer key.
Send a QID and read accepted_qid.

POST /v1/matches

curl --request POST \
  'https://cinematch-next.p.rapidapi.com/v1/matches' \
  --header "X-RapidAPI-Key: $RAPIDAPI_KEY" \
  --header 'X-RapidAPI-Host: cinematch-next.p.rapidapi.com' \
  --header 'Content-Type: application/json' \
  --data '{"query":{"external_ids":{"wikidata":"Q25188"}},"limit":5}'

200 OK · SHORTENED REAL RESPONSE{"result":{"status":"matched","accepted_qid":"Q25188"}}

Keep your key private. This page never asks for it and never sends API requests. Explore the public Postman collection or download it to import.

START BUILDING

Free BASIC.
A practical first step.

Ongoing development. A working API you can try today.

$0 / month

1,100 Requests total per month
Up to 1,000 Singles and 100 Batches
Up to 10 movie queries per batch
Hard business quotas, no business overage

Get your consumer key ↗

Each single or batch uses one Requests. RapidAPI includes 10 GB of bandwidth per subscription cycle, then charges $1 per extra GB proportionally. Check platform terms and checkout.

Built for careful matching.

Suggestions help you find a film; they are not automatically confirmed identities. The catalogue is finite, and availability and throughput are shared. Start with one request in flight, respect retry instructions and review ambiguous results. No contractual SLA is offered.

Find the movie.Connect the IDs.

Same film.Many ways to find it.