---
title: "GET /watch/promos/popular"
method: GET
path: "/watch/promos/popular"
tags: ["watch"]
---

# GET /watch/promos/popular

`GET /watch/promos/popular`

## Request

- Base URL: `https://api.jikan.moe/v4`
- URL: `https://api.jikan.moe/v4/watch/promos/popular`
- Auth: none declared

## Response `200`

Returns Popular Promotional Videos

- WatchPromos: Watch Promos
  - `pagination` object
    - `last_visible_page` integer
    - `has_next_page` boolean
  - `data` object[]
    - `title` string: Promo Title
    - `entry` AnimeMeta
      - `mal_id` integer: MyAnimeList ID
      - `url` string: MyAnimeList URL
      - `images` AnimeImages
        - `jpg` object: Available images in JPG
          - `image_url` string, nullable: Image URL JPG
          - `small_image_url` string, nullable: Small Image URL JPG
          - `large_image_url` string, nullable: Image URL JPG
        - `webp` object: Available images in WEBP
          - `image_url` string, nullable: Image URL WEBP
          - `small_image_url` string, nullable: Small Image URL WEBP
          - `large_image_url` string, nullable: Image URL WEBP
      - `title` string: Entry title
    - `trailer` Trailer: Youtube Images
      - `youtube_id` string, nullable: YouTube ID
      - `url` string, nullable: YouTube URL
      - `embed_url` string, nullable: Parsed Embed URL
      - `images` object
        - `image_url` string, nullable: Default Image Size URL (120x90)
        - `small_image_url` string, nullable: Small Image Size URL (640x480)
        - `medium_image_url` string, nullable: Medium Image Size URL (320x180)
        - `large_image_url` string, nullable: Large Image Size URL (480x360)
        - `maximum_image_url` string, nullable: Maximum Image Size URL (1280x720)

## Other responses

- `400`: Error: Bad request. When required parameters were not supplied.

## Changes

- **2025-04-17** `d5c44f85ceb6`: 1 breaking, 2 info
  - the `allOf[subschema #2]/` response's property type changed from no type to `object` for status `200`
  - added the optional property `allOf[subschema #2]/data` to the response with the `200` status
  - removed `subschema #1, subschema #2` from the `allOf[subschema #2]/` response property `allOf` list for the response status `200`
- **2023-06-02** `e5c562e7ba46`: 1 warning
  - deleted the `query` request parameter `limit`
- **2022-05-20** `2873a920040a`: 1 info
  - added the new optional `query` request parameter `limit`

[Operation history](https://skmtc.dev/jikan/apis/jikan-api/changes/watch/promos/popular/get.md)

---

[API](https://skmtc.dev/jikan/apis/jikan-api.md) - [All operations](https://skmtc.dev/jikan/apis/jikan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jikan/apis/jikan-api/revisions/ae6dd9d554d6?raw)