---
title: "Changes to Search YouTube videos or channels"
method: GET
path: "/api/v2/youtube/search"
---

# Changes to Search YouTube videos or channels

`GET /api/v2/youtube/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 7 revisions.

- **2026-10-07** `6380d033643e`: 3 warning
- **2026-09-18** `fefff856887d`: 1 breaking, 9 info

## Changes

- **2026-10-07** `6380d033643e`: 3 warning
  - the optional response header `X-RateLimit-Limit` removed for the status `429`
  - the optional response header `X-RateLimit-Remaining` removed for the status `429`
  - the optional response header `X-RateLimit-Reset` removed for the status `429`
- **2026-09-18** `fefff856887d`: 1 breaking, 9 info
  - added `#/components/schemas/VideoResult, #/components/schemas/ChannelResult, #/components/schemas/SearchPlaylistResult` to the `results/items/` response property `oneOf` list for the response status `200`
  - added the new optional `query` request parameter `duration`
  - added the new optional `query` request parameter `features`
  - added the new optional `query` request parameter `sort`
  - added the new optional `query` request parameter `sp`
  - added the new optional `query` request parameter `upload_date`
  - added the new enum value `movie` to the `query` request parameter `type`
  - added the new enum value `playlist` to the `query` request parameter `type`
  - removed `#/components/schemas/VideoResult, #/components/schemas/ChannelResult` from the `results/items/` response property `anyOf` list for the response status `200`
  - added discriminator to `results/items/` response property for the response status `200`

---

[Operation](https://skmtc.dev/transcriptapi/apis/youtube-transcript-api-public/docs/api/v2/youtube/search/get.md) - [API](https://skmtc.dev/transcriptapi/apis/youtube-transcript-api-public.md) - [Page](https://skmtc.dev/transcriptapi/apis/youtube-transcript-api-public/changes/api/v2/youtube/search/get)