{
  "openapi": "3.0.0",
  "info": {
    "title": "IMDb News by Category API (V1)",
    "version": "1.0.0",
    "description": "Get IMDb news by Category data, including headlines, summaries, and source metadata, for media monitoring and news research."
  },
  "paths": {
    "/api/imdb/news-by-category-query/v1": {
      "get": {
        "tags": [
          "IMDb"
        ],
        "summary": "News by Category",
        "description": "Get IMDb news by Category data, including headlines, summaries, and source metadata, for media monitoring and news research.",
        "operationId": "newsByCategoryQuery",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "User's authentication token.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "News category to filter by.\n\nAvailable Values:\n- `TOP`: Top News\n- `MOVIE`: Movie News\n- `TV`: TV News\n- `CELEBRITY`: Celebrity News",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Categories for IMDb news.",
              "enum": [
                "TOP",
                "MOVIE",
                "TV",
                "CELEBRITY"
              ]
            }
          },
          {
            "name": "languageCountry",
            "in": "query",
            "description": "Language and country preferences.\n\nAvailable Values:\n- `en_US`: English (US)\n- `fr_CA`: French (Canada)\n- `fr_FR`: French (France)\n- `de_DE`: German (Germany)\n- `hi_IN`: Hindi (India)\n- `it_IT`: Italian (Italy)\n- `pt_BR`: Portuguese (Brazil)\n- `es_ES`: Spanish (Spain)\n- `es_US`: Spanish (US)\n- `es_MX`: Spanish (Mexico)",
            "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": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "news": {
                      "__typename": "NewsConnection",
                      "edges": [
                        {
                          "node": {
                            "__typename": "News",
                            "id": "ni65740975",
                            "byline": "Rebecca Rubin",
                            "date": "2026-03-08T16:49:37Z",
                            "externalUrl": "https://variety.com/2026/film/box-office/pixar-hoppers-box-office-global-opening-weekend-win-the-bri...",
                            "articleTitle": {
                              "plainText": "Box Office: ‘Hoppers’ Powers to $88 Million Globally, ‘The Bride!’ Flatlines With $13 Million Worldw..."
                            },
                            "image": {
                              "__typename": "Image",
                              "id": "rm805281794",
                              "url": "https://m.media-amazon.com/images/M/MV5BNzRiMzZlMTMtNmU3OC00MDUwLThmNDUtMTBjZmQ3MWQ4NTljXkEyXkFqcGc@...",
                              "height": 1610,
                              "width": 1086
                            },
                            "text": {
                              "plainText": "Disney’s Pixar animal adventure “Hoppers” was No. 1 at the global box office with $88 million, an en..."
                            },
                            "source": {
                              "homepage": {
                                "url": "http://variety.com/",
                                "label": "Variety - Film News"
                              },
                              "description": null
                            }
                          }
                        }
                      ],
                      "total": 796276,
                      "pageInfo": {
                        "__typename": "NewsPageInfo",
                        "hasNextPage": true,
                        "endCursor": "NjU3Mzk4NDd8MjAyNi0wMy0wNyAxODowMDowMA"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": 34002600
      }
    }
  },
  "components": {}
}