Endpoint Playground
Searches theatrical box-office records from Box Office Mojo charts and title pages. Filter by title id, year, franchise/brand/genre, gross band, lifetime top-1000 membership, hydration status, and worldwide/domestic gross ranges. Sort enum: `relevance`, `worldwide_desc`, `domestic_desc`, `peak_worldwide_desc`, `lifetime_rank_asc`, `year_desc`, `year_asc`. gross_band enum: `under_50m`, `50_100m`, `100_250m`, `250_500m`, `500m_1b`, `over_1b`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100). Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 1 items; 31 fields had a value in every checked item.
Sample value profiles: first_seen_at: 2026-07-19; title_url: boxofficemojo.com; in_lifetime_top_1000_ww: true in 1 of 1.
curl 'https://api.crawlora.net/api/v1/datasets/boxofficemojo/search?gross_band=under_50m&sort=relevance' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text query over title and taxonomy names, max 256 characters | |
| title_id | string | No | Exact title id (IMDb tt… id used by Box Office Mojo), max 32 characters | |
| year | integer | No | Year that must appear in years_active | |
| lifetime_year | integer | No | Primary lifetime chart year | |
| gross_band | string | No | under_50m | Gross band enum: under_50m, 50_100m, 100_250m, 250_500m, 500m_1b, over_1b |
| franchise | string | No | Franchise name filter, max 128 characters | |
| brand | string | No | Brand name filter, max 128 characters | |
| genre | string | No | Genre name filter, max 128 characters | |
| in_lifetime_top_1000 | boolean | No | Only titles in the lifetime worldwide top 1000 chart | |
| hydrated | boolean | No | Only titles with hydrated release groups and market grosses | |
| is_billion_dollar | boolean | No | Only titles with worldwide gross of at least $1B | |
| min_worldwide | integer | No | Minimum lifetime worldwide gross in whole USD dollars | |
| max_worldwide | integer | No | Maximum lifetime worldwide gross in whole USD dollars | |
| min_domestic | integer | No | Minimum lifetime domestic gross in whole USD dollars | |
| min_foreign_share | number | No | Minimum foreign share of worldwide gross, 0 through 1 | |
| max_domestic_share | number | No | Maximum domestic share of worldwide gross, 0 through 1 | |
| sort | string | No | relevance | Sort enum: relevance, worldwide_desc, domestic_desc, peak_worldwide_desc, lifetime_rank_asc, year_desc, year_asc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "boxofficemojo",
"items": [
{
"title_id": "tt0499549",
"title": "Avatar",
"lifetime_gross_worldwide": 2923710708,
"gross_band": "over_1b",
"is_billion_dollar": true,
"hydrated": true
}
],
"page": 1,
"page_size": 20,
"total": 1000,
"sort": "worldwide_desc"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.