{
    "meta": {
        "generated_at": "2026-11-03T23:08:31Z",
        "endpoints_count": 12,
        "credit_cost": 0
    },
    "data": {
        "endpoints": [
            {
                "name": "search",
                "group": "Finding an endpoint",
                "summary": "Turn a title, franchise or half-remembered phrase into the endpoint that serves it. START HERE: an od_name carries the year, so /movie/Avatar is a 404 and a slug cannot be guessed.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/search?q=star+wars",
                        "credits": 1
                    }
                ]
            },
            {
                "name": "movie",
                "group": "One film",
                "summary": "Everything on record for one film: production budget, worldwide box office, rating, genre and classification.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/movie/Avatar-(2009)",
                        "credits": 3
                    }
                ]
            },
            {
                "name": "movie-cast-and-crew",
                "group": "One film",
                "summary": "Cast and crew for one film, with their roles.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/movie/Avatar-(2009)/cast-and-crew",
                        "credits": 1
                    }
                ]
            },
            {
                "name": "movie-domestic",
                "group": "One film",
                "summary": "One film's full domestic theatrical run, chart by chart.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/movie/Avatar-(2009)/domestic",
                        "credits": 15
                    }
                ]
            },
            {
                "name": "movie-international",
                "group": "One film",
                "summary": "One film's box office and release dates, territory by territory.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/movie/Avatar-(2009)/international",
                        "credits": 15
                    }
                ]
            },
            {
                "name": "franchise",
                "group": "One film",
                "summary": "A franchise and every film in it.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/movies/franchise/Marvel-Cinematic-Universe",
                        "credits": 3
                    }
                ]
            },
            {
                "name": "daily-box-office",
                "group": "Charts",
                "summary": "The daily box-office chart: the current edition, or any past date.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/daily-box-office-chart",
                        "credits": 1
                    },
                    {
                        "url": "https://api.the-numbers.com/box-office-chart/daily/{YYYY}/{MM}/{DD}",
                        "credits": 15
                    }
                ]
            },
            {
                "name": "weekend-box-office",
                "group": "Charts",
                "summary": "The weekend box-office chart: the current edition, or any past weekend.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/weekend-box-office-chart",
                        "credits": 1
                    },
                    {
                        "url": "https://api.the-numbers.com/box-office-chart/weekend/{YYYY}/{MM}/{DD}",
                        "credits": 15
                    }
                ]
            },
            {
                "name": "weekly-box-office",
                "group": "Charts",
                "summary": "The weekly box-office chart: the current edition, or any past week.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/weekly-box-office-chart",
                        "credits": 1
                    },
                    {
                        "url": "https://api.the-numbers.com/box-office-chart/weekly/{YYYY}/{MM}/{DD}",
                        "credits": 15
                    }
                ]
            },
            {
                "name": "market-top-grossing-movies",
                "group": "Charts",
                "summary": "Top-grossing films for a year, at actual or inflation-adjusted values.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/market/2025/top-grossing-movies",
                        "credits": 3
                    },
                    {
                        "url": "https://api.the-numbers.com/market/2025/top-grossing-movies/inflation-adjusted",
                        "credits": 3
                    }
                ]
            },
            {
                "name": "reports",
                "group": "Reports",
                "summary": "The reports you have saved in the Report Builder, with the id each one is read by. START HERE for reports: ids are not guessable and are created on the website, not through the API.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/reports",
                        "credits": 0
                    }
                ]
            },
            {
                "name": "report-view",
                "group": "Reports",
                "summary": "A saved Report Builder report: a filtered slice of the catalogue, capped at 100 rows. The report_id comes from /reports -- ids are minted on the website and cannot be guessed. The filters are fixed when the report is written, so this reads one slice and is not a query endpoint.",
                "examples": [
                    {
                        "url": "https://api.the-numbers.com/report/{report_id}",
                        "credits": 3
                    }
                ]
            }
        ]
    }
}