---
title: "Box Office Mojo lifetime gross chart"
method: GET
path: "/boxofficemojo/lifetime-grosses"
tags: ["Box Office Mojo"]
---

# Box Office Mojo lifetime gross chart

`GET /boxofficemojo/lifetime-grosses`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/boxofficemojo/lifetime-grosses`
- Auth: API key in header `x-api-key`

Returns one page of Box Office Mojo's lifetime gross chart of movies. `area` is `worldwide` (default) or `domestic`, and `offset` pages in steps of 200 from 0 to 800. Each row has `rank`, `title`, `title_id`, `year` and `lifetime_gross` as an integer, with the displayed text in `lifetime_gross_raw`.

## Query parameters

- `area` 'worldwide' | 'domestic'
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BoxofficemojoLifetimeGrossesResponseDoc
  - `code` integer
  - `data` BoxofficemojoLifetimeGrossesResponse
    - `area` string: Chart area that was returned: `worldwide` or `domestic`.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `offset` integer: Number of rows skipped before this page, in steps of 200.
    - `public_page_derived` boolean: Always `true`; the values come from Box Office Mojo's public pages.
    - `range` string: Range of ranks shown and the chart size, for example `1-200 of 1,000`.
    - `results` BoxofficemojoLifetimeGrossRow[]: Rows of the lifetime gross chart, one per title, in chart order.
      - `lifetime_gross` integer: Lifetime gross of the title, in US dollars.
      - `lifetime_gross_raw` string: Lifetime gross, as Box Office Mojo displays it, for example `$2,923,710,708`.
      - `rank` integer: Position on the lifetime gross chart.
      - `title` string: Title name as shown on the chart.
      - `title_id` string: Title id of the film, starting with `tt`. Use it with the title endpoint.
      - `title_path` string: Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
      - `title_url` string: Full URL of the title page on Box Office Mojo.
      - `year` integer: Release year of the title.
    - `source_url` string: URL of the Box Office Mojo page the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)