Skip to main content
GET
/
movie
/
upcoming
Upcoming
curl --request GET \
  --url https://api.themoviedb.org/3/movie/upcoming \
  --header 'Authorization: Bearer <token>'
{
  "dates": {
    "maximum": "2025-01-29",
    "minimum": "2025-01-08"
  },
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/zOpe0eHsq0A2NvNyBbtT6sj53qV.jpg",
      "genre_ids": [
        28,
        878,
        35,
        10751
      ],
      "id": 939243,
      "original_language": "en",
      "original_title": "Sonic the Hedgehog 3",
      "overview": "Sonic, Knuckles, and Tails reunite against a powerful new adversary, Shadow, a mysterious villain with powers unlike anything they have faced before. With their abilities outmatched in every way, Team Sonic must seek out an unlikely alliance in hopes of stopping Shadow and protecting the planet.",
      "popularity": 3125.84,
      "poster_path": "/mubt4bnVfpJ5lBMq93DidEuMkJr.jpg",
      "release_date": "2024-12-19",
      "title": "Sonic the Hedgehog 3",
      "video": false,
      "vote_average": 7.696,
      "vote_count": 245
    },
    {
      "adult": false,
      "backdrop_path": "/dWkdmxIkH9y23s9v1PjQFhTGIwo.jpg",
      "genre_ids": [
        28,
        18,
        53
      ],
      "id": 1043905,
      "original_language": "en",
      "original_title": "Dirty Angels",
      "overview": "During the United States' 2021 withdrawal from Afghanistan, a group of female soldiers posing as medical relief are sent back in to rescue a group of kidnapped teenagers caught between ISIS and the Taliban.",
      "popularity": 1385.471,
      "poster_path": "/3O3qSGmjRGc10hMwFul8WDxKE5t.jpg",
      "release_date": "2024-12-11",
      "title": "Dirty Angels",
      "video": false,
      "vote_average": 6.886,
      "vote_count": 70
    },
    {
      "adult": false,
      "backdrop_path": "/au3o84ub27qTZiMiEc9UYzN74V3.jpg",
      "genre_ids": [
        28,
        878,
        53
      ],
      "id": 1035048,
      "original_language": "en",
      "original_title": "Elevation",
      "overview": "A single father and two women venture from the safety of their homes to face monstrous creatures to save the life of a young boy.",
      "popularity": 1225.181,
      "poster_path": "/sLJqbUymYkLvoNt4E7DG2E4ia6y.jpg",
      "release_date": "2024-11-07",
      "title": "Elevation",
      "video": false,
      "vote_average": 6.283,
      "vote_count": 214
    },
    {
      "adult": false,
      "backdrop_path": "/1pmXyN3sKeYoUhu5VBZiDU4BX21.jpg",
      "genre_ids": [
        16,
        28,
        878,
        10751
      ],
      "id": 1184918,
      "original_language": "en",
      "original_title": "The Wild Robot",
      "overview": "After a shipwreck, an intelligent robot called Roz is stranded on an uninhabited island. To survive the harsh environment, Roz bonds with the island's animals and cares for an orphaned baby goose.",
      "popularity": 909.544,
      "poster_path": "/9w0Vh9eizfBXrcomiaFWTIPdboo.jpg",
      "release_date": "2024-09-08",
      "title": "The Wild Robot",
      "video": false,
      "vote_average": 8.376,
      "vote_count": 3730,
      "total_pages": 41,
      "total_results": 812
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
language
string

Defaults to en-US

​
page
integer

Defaults to 1

​
region
string

ISO-3166-1 code

Response

200 - application/json

Successful

​
date
object[]

Objects grouped by specific dates

​
page
integer

Indicates the current page number

​
results
object[]

Contains the list of data or items

​
total_pages
integer

Specifies the total number of pages available

​
total_results
integer

Represents the total number of items or records in a dataset