Back to catalog

Youtube · Social

YouTube Data API v3 (converted from Google Discovery) / Retrieves a list of search resources

Retrieves a list of search resources

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • channelId query · optional

    Filter on resources belonging to this channelId. (Force TAP rebuild)

  • channelType query · optional

    Add a filter on the channel search.

  • eventType query · optional

    Filter on the livestream status of the videos.

  • location query · optional

    Filter on location of the video

  • locationRadius query · optional

    Filter on distance from the location (specified above).

  • maxResults query · optional

    The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.

  • order query · optional

    Sort order of the results.

  • pageToken query · optional

    The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.

  • part query · required
  • publishedAfter query · optional

    Filter on resources published after this date.

  • publishedBefore query · optional

    Filter on resources published before this date.

  • q query · optional

    Textual search terms to match.

  • regionCode query · optional

    Display the content as seen by viewers in this country.

  • relevanceLanguage query · optional

    Return results relevant to this language.

  • safeSearch query · optional

    Indicates whether the search results should include restricted content as well as standard content.

  • topicId query · optional

    Restrict results to a particular topic.

  • type query · optional
  • videoCaption query · optional

    Filter on the presence of captions on the videos.

  • videoCategoryId query · optional

    Filter on videos in a specific category.

  • videoDefinition query · optional

    Filter on the definition of the videos.

  • videoDimension query · optional

    Filter on 3d videos.

  • videoDuration query · optional

    Filter on the duration of the videos.

  • videoEmbeddable query · optional

    Filter on embeddable videos.

  • videoLicense query · optional

    Filter on the license of the videos.

  • videoPaidProductPlacement query · optional
  • videoSyndicated query · optional

    Filter on syndicated videos.

  • videoType query · optional

    Filter on videos of a specific type.

No allowlisted official documentation or pricing reference is available.

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.