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.
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.