CinemaIP Data API

Indian box office,
as an API.

Live grosses by region, city, theatre and chain. Charts, a clean movie catalog, actor filmographies, mood recommendations and where-to-watch — one key, one consistent contract.

Updated hourly India · US · Middle East GST invoices
curl
curl "https://cinemaip-api-48276813435.asia-south1.run.app/v1/boxoffice/charts?days=7&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"
What you can build with

Seven APIs. One key.

Each plan unlocks a set of products. Call any of them with the same key, the same error codes and the same conventions.

boxoffice.live

Gross, net, tickets and occupancy for any title — India, US and the Middle East — down to state, city, show slot and language. Updated hourly.

GET /v1/boxoffice/{cpid}

boxoffice.charts

The top movies by gross over any window up to 30 days, with daily totals — the leaderboard behind every trade headline.

GET /v1/boxoffice/charts

boxoffice.theatres

One title’s run, theatre by theatre and exhibitor chain by chain (PVR INOX, Cinepolis, Miraj…), filterable by state, city and dates.

GET /v1/boxoffice/{cpid}/theatresGET /v1/boxoffice/{cpid}/chains

catalog

Clean metadata for Indian cinema: certification, languages, genres, runtime, synopsis, release date, cast and crew.

GET /v1/moviesGET /v1/movies/{cpid}

people

Actor and crew filmographies with each film’s box office and verdict, plus a lead-role career summary.

GET /v1/peopleGET /v1/people/{person_id}

recommendations

Ranked picks for who you’re watching with and the mood — filtered by language, streaming platform and recency.

POST /v1/recommendations/mood

watch

Which Indian streaming platforms carry a title, with deep links straight to it.

GET /v1/movies/{cpid}/watch
Pricing

Start free. Pay as you grow.

Prepaid plans — nothing renews or charges you automatically.

Data you can defend

Numbers built to be quoted.

Null means not measured

A missing figure is null, never 0. “Made no money” and “not reported” are different answers, and we never blur them.

All money in INR

Every rupee figure is INR — US and Gulf runs included — and regions are reported side by side, never summed across currencies.

Hourly, and honest about it

The feed lands hourly and revises the trailing three days. Every response carries the date its data runs through.

Stable, versioned contracts

/v1 fields are documented and kept. No internal columns, no deprecated aliases, machine-readable error codes.

FAQ

Questions, answered.

Sign in, open the Data API dashboard and create your account — you start on the Free plan with a key straight away. No card needed.

Talk to us

Enterprise, custom data, or a question?

Higher limits, contracts and invoicing, or a dataset we don't list yet — tell us what you need.

Already a customer? Open your dashboard.

hometrailersmusic