Box Office Mojo Scraper API

Hinweise zur Response

- `data.public_page_derived` is `true`. - `lifetime_gross` is a parsed integer when the page exposes a money value; `lifetime_gross_raw` keeps the visible upstream text. - Upstream challenge pages, malformed table data, or parser drift are returned as typed upstream errors. Example response: ```json { "code": 200, "msg": "OK", "data": { "area": "worldwide", "offset": 0, "range": "1-200 of 1,000", "results": [ { "rank": 1, "title": "Avatar", "title_id": "tt0499549", "lifetime_gross": 2923710708, "lifetime_gross_raw": "$2,923,710,708", "year": 2009 } ], "public_page_derived": true } } ```

Hinweise zur Response

- The response includes the requested year, `grosses_option`, source URL, fetch time, and normalized domestic yearly rows. - Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload. Example response: ```json { "code": 200, "msg": "OK", "data": { "year": 2025, "grosses_option": "calendar_grosses", "results": [ { "rank": 1, "release": "Lilo & Stitch", "gross_raw": "$423,778,855" } ], "public_page_derived": true } } ```

Hinweise zur Response

- The response includes the requested year, source URL, fetch time, and normalized yearly box office rows. - Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload. Example response: ```json { "code": 200, "msg": "OK", "data": { "year": 2025, "results": [ { "rank": 1, "release_group": "Ne Zha 2", "worldwide_raw": "$2,267,446,370" } ], "public_page_derived": true } } ```

Hinweise zur Response

- The response includes the requested year/week, date range when present, source URL, fetch time, and normalized weekend rows. - Empty upstream weekend pages return a typed not-found error rather than an empty success payload. - Parser drift, challenge pages, or malformed upstream tables return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "year": 2025, "week": 52, "results": [ { "rank": 1, "release": "Avatar: Fire and Ash", "gross_raw": "$63,087,667" } ], "public_page_derived": true } } ```

Hinweise zur Response

- `data.public_page_derived` is `true`. - `release_groups` contains rollout-level domestic, international, and worldwide grosses. - `market_grosses` contains the visible regional market tables when present. - Upstream challenge pages, malformed table data, missing title markers, or parser drift are returned as typed upstream errors. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Avatar", "title_id": "tt0499549", "release_groups": [ { "name": "Original Release", "markets": "77 markets", "worldwide": 2743577587, "worldwide_raw": "$2,743,577,587" } ], "public_page_derived": true } } ```

Hinweise zur Response

- The response includes title, release id, source URL, summary fields, and domestic daily rows. - Parser drift, challenge pages, malformed upstream tables, or missing required release markers return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Avatar: Fire and Ash", "release_id": "rl3389031937", "summary": { "distributor": "20th Century Studios", "opening_raw": "$89,160,860" }, "daily_grosses": [ { "date": "Dec 25", "daily_gross_raw": "$24,096,415" } ], "public_page_derived": true } } ```