Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Showtimes 获取排期列表

GET/POST /v1/web/movie/showtimes

  • =》
{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "city_id": 30907, //选填:默认为所有
  "movie_id": 17403,  //选填:电影ID
  "cinema_id": 65789, //选填:影院ID
  "date": "2025-04-23", //选填:默认为今天
}

注意:

1、movie_id、cinema_id 二个参数均为可选,但是二个参数不能全为空;

2、使用movie_id与使用cinema_id返回的数据结构与内容不一样!

1. 根据movie_id来调用接口

  • 《=
{
  "success": "OK",
  "data": {
    "date": "2025-04-23",
    "dates": [
      "2025-05-15",
      "2025-05-16",
      "2025-05-17",
      "2025-05-18",
      "2025-05-19",
      "2025-05-20",
      "2025-05-21"
    ],
    "movie": {
      "cinema_id": 65789,
      "movie_id": 198725,
      "title": "A Minecraft Movie",
      "language": "en",
      "runtime": 101,
      "genres": [
        {
          "id": "7",
          "name": "Family"
        },
        {
          "id": "3",
          "name": "Comedy"
        },
        {
          "id": "1",
          "name": "Adventure"
        }
      ],
      "summary": "Four misfits find themselves struggling with ordinary problems when they are suddenly pulled through a mysterious portal into the Overworld: a bizarre, cubic wonderland that thrives on imagination. To get back home, they'll have to master this world while embarking on a magical quest with an unexpected, expert crafter, Steve.",
      "cover": "https://image.tmdb.org/t/p/w500/yFHHfHcUgGAxziP1C3lLt0q2T4s.jpg",
      "casts": [
        {
          "id": "20a19472d9075bea59aff3c8e3bc667a",
          "character": "Garrett",
          "name": "Jason Momoa"
        },
        {
          "id": "ced6bcc4a4f04fbc93caa74b34557df8",
          "character": "Steve",
          "name": "Jack Black"
        }
      ],
      "crews": [
        {
          "id": "3619b4f2c5c5732951d05d09c8b71da9",
          "name": "Jared Hess",
          "job": "director"
        }
      ]
    },
    "showtimes": [
      {
        "cinema_id": 67079,
        "cinema_name": "VOX Atyaf Mall - Riyadh",
        "play_times": [
          "02:15",
          "13:45",
          "16:15"
        ]
      },
      {
        "cinema_id": 68469,
        "cinema_name": "EMPIRE CINEMAS,ABHA",
        "play_times": [
          "03:00",
          "10:00",
          "12:25",
          "14:00",
          "14:50",
          "16:45",
          "17:15",
          "18:25"
        ]
      },
      {
        "cinema_id": 78006,
        "cinema_name": "Al Madina Al Munawarah - Al Rashid Mall",
        "play_times": [
          "03:00",
          "10:25",
          "12:45",
          "15:05",
          "17:25"
        ]
      }
    ]
  }
}

2. 根据cinema_id来调用接口

  • 《=

{
  "success": "OK",
  "data": {
    "date": "2025-04-24",
    "dates": [
      "2025-05-15",
      "2025-05-16",
      "2025-05-17",
      "2025-05-18",
      "2025-05-19",
      "2025-05-20",
      "2025-05-21"
    ],
    "cinema": {
      "cinema_id": 65789,
      "name": "VOX West Avenue Mall Dammam",
      "city": "Dammam",
      "city_id": 25730,
      "address": "Omar Ibn Al Khattab St, Al Faysaliyah, Dammam 32271, Saudi Arabia. Ground floor"
    },
    "showtimes": [
      {
        "movie": {
          "cinema_id": 65789,
          "movie_id": 177849,
          "title": "A Minecraft Movie",
          "language": "en",
          "runtime": 101,
          "genres": [
            {
              "id": "7",
              "name": "Family"
            },
            {
              "id": "3",
              "name": "Comedy"
            }
          ],
          "summary": "Four misfits find themselves struggling with ordinary problems when they are suddenly pulled through a mysterious portal into the Overworld: a bizarre, cubic wonderland that thrives on imagination. To get back home, they'll have to master this world while embarking on a magical quest with an unexpected, expert crafter, Steve.",
          "cover": "https://image.tmdb.org/t/p/w500/yFHHfHcUgGAxziP1C3lLt0q2T4s.jpg",
          "casts": [
            {
              "id": "20a19472d9075bea59aff3c8e3bc667a",
              "character": "Garrett",
              "name": "Jason Momoa"
            },
            {
              "id": "ced6bcc4a4f04fbc93caa74b34557df8",
              "character": "Steve",
              "name": "Jack Black"
            }
          ],
          "crews": [
            {
              "id": "3619b4f2c5c5732951d05d09c8b71da9",
              "name": "Jared Hess",
              "job": "director"
            }
          ]
        },
        "play_times": [
          "19:05"
        ]
      },
      {
        "movie": {
          "cinema_id": 65789,
          "movie_id": 46190,
          "title": "A Minecraft Movie",
          "language": "en",
          "runtime": 101,
          "genres": [
            {
              "id": "7",
              "name": "Family"
            },
            {
              "id": "3",
              "name": "Comedy"
            }
          ],
          "summary": "Four misfits find themselves struggling with ordinary problems when they are suddenly pulled through a mysterious portal into the Overworld: a bizarre, cubic wonderland that thrives on imagination. To get back home, they'll have to master this world while embarking on a magical quest with an unexpected, expert crafter, Steve.",
          "cover": "https://image.tmdb.org/t/p/w500/yFHHfHcUgGAxziP1C3lLt0q2T4s.jpg",
          "casts": [
            {
              "id": "20a19472d9075bea59aff3c8e3bc667a",
              "character": "Garrett",
              "name": "Jason Momoa"
            },
            {
              "id": "ced6bcc4a4f04fbc93caa74b34557df8",
              "character": "Steve",
              "name": "Jack Black"
            }
          ],
          "crews": [
            {
              "id": "3619b4f2c5c5732951d05d09c8b71da9",
              "name": "Jared Hess",
              "job": "director"
            }
          ]
        },
        "play_times": [
          "11:00",
          "11:30",
          "13:45",
          "15:00",
          "15:30",
          "16:00",
          "19:30"
        ]
      }
    ]
  }
}