{
  "openapi": "3.0.0",
  "info": {
    "title": "IMDb榜单排名 API (V1)",
    "version": "1.0.0",
    "description": "获取IMDb标题榜单排名数据，包括在Top 250等榜单和相关图表中的位置，用于排名监控和标题基准测试。"
  },
  "paths": {
    "/api/imdb/title-chart-rankings/v1": {
      "get": {
        "tags": [
          "IMDb"
        ],
        "summary": "榜单排名",
        "description": "获取IMDb标题榜单排名数据，包括在Top 250等榜单和相关图表中的位置，用于排名监控和标题基准测试。",
        "operationId": "titleChartRankings",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "用户的鉴权令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "rankingsChartType",
            "in": "query",
            "description": "要获取的排行榜类型。\n\n可用值：\n- `TOP_250`: 电影 Top 250\n- `TOP_250_TV`: 电视剧 Top 250",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Chart types for IMDb rankings.",
              "enum": [
                "TOP_250",
                "TOP_250_TV"
              ]
            }
          },
          {
            "name": "languageCountry",
            "in": "query",
            "description": "语言与国家/地区偏好。\n\n可用值：\n- `en_US`: 英语（美国）\n- `fr_CA`: 法语（加拿大）\n- `fr_FR`: 法语（法国）\n- `de_DE`: 德语（德国）\n- `hi_IN`: 印地语（印度）\n- `it_IT`: 意大利语（意大利）\n- `pt_BR`: 葡萄牙语（巴西）\n- `es_ES`: 西班牙语（西班牙）\n- `es_US`: 西班牙语（美国）\n- `es_MX`: 西班牙语（墨西哥）",
            "required": false,
            "schema": {
              "type": "string",
              "default": "en_US",
              "description": "Language and country options for IMDb data.",
              "enum": [
                "en_US",
                "fr_CA",
                "fr_FR",
                "de_DE",
                "hi_IN",
                "it_IT",
                "pt_BR",
                "es_ES",
                "es_US",
                "es_MX"
              ]
            }
          }
        ],
        "responses": {
          "default": {
            "description": "默认响应",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "titleChartRankings": {
                      "edges": [
                        {
                          "node": {
                            "item": {
                              "__typename": "Title",
                              "id": "tt0111161",
                              "titleText": {
                                "text": "The Shawshank Redemption",
                                "isOriginalTitle": true
                              },
                              "originalTitleText": {
                                "text": "The Shawshank Redemption",
                                "isOriginalTitle": true
                              },
                              "releaseYear": {
                                "__typename": "YearRange",
                                "year": 1994,
                                "endYear": null
                              },
                              "releaseDate": {
                                "__typename": "ReleaseDate",
                                "month": 10,
                                "day": 14,
                                "year": 1994,
                                "country": {
                                  "id": "US"
                                },
                                "restriction": null,
                                "attributes": [],
                                "displayableProperty": {
                                  "qualifiersInMarkdownList": null
                                }
                              },
                              "titleType": {
                                "__typename": "TitleType",
                                "id": "movie",
                                "text": "Movie",
                                "categories": [
                                  {
                                    "id": "movie",
                                    "text": "Movie",
                                    "value": "movie"
                                  }
                                ],
                                "canHaveEpisodes": false,
                                "isEpisode": false,
                                "isSeries": false,
                                "displayableProperty": {
                                  "value": {
                                    "plainText": ""
                                  }
                                }
                              },
                              "primaryImage": {
                                "__typename": "Image",
                                "id": "rm1690056449",
                                "url": "https://m.media-amazon.com/images/M/MV5BMDAyY2FhYjctNDc5OS00MDNlLThiMGUtY2UxYWVkNGY2ZjljXkEyXkFqcGc@...",
                                "height": 1800,
                                "width": 1200
                              },
                              "canRate": {
                                "isRatable": true
                              },
                              "ratingsSummary": {
                                "voteCount": 3165732,
                                "aggregateRating": 9.3,
                                "topRanking": {
                                  "rank": 1
                                }
                              }
                            },
                            "chartRating": 9.239942913183347,
                            "chartVoteCount": 3165758
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": 34002700
      }
    }
  },
  "components": {}
}