YouTube Search
Search videos, channels and playlists.
YouTube Search
Search YouTube for videos, channels and playlists. engine=youtube and q are required. Use gl and hl for country and language, or sp for pagination and advanced filters.
- enumengineconst:youtuberequired
SearchApi engine identifier. Use
youtubefor this YouTube endpoint.values- youtube
- Type: stringqrequired
Search query. Required by runtime and upstream SearchApi.
- Type: stringsp
YouTube filter token (pagination or advanced filters)
- Type: stringgl
Country code (e.g. us, jp)
- Type: stringhl
Interface language
- Type: object200
Successful YouTube search response
YouTube search result payload.
- Type: array object[]ads
- propertyType: anything
Name
- Type: array object[]channels
- descriptionType: string
- idType: string
- linkType: string
- positionType: integer
Integer numbers.
- subscribersType: string
- thumbnailType: string
- titleType: string
- propertyType: anything
Name
- Type: objectpagination
- nextType: string
_page _token - propertyType: anything
Name
- Type: array object[]playlists
- propertyType: anything
Name
- Type: objectsearch
_information - totalType: integer
_results Integer numbers.
- propertyType: anything
Name
- Type: objectsearch
_metadata - createdType: string
_at - htmlType: string
_url - idType: string
- jsonType: string
_url - parsingType: number
_time _taken - requestType: number
_time _taken - requestType: string
_url - statusType: string
- totalType: number
_time _taken - propertyType: anything
Name
- Type: objectsearch
_parameters - propertyType: anything
Name
- Type: array object[]sections
- itemsType: array object[]
- propertyType: anything
Name
- positionType: integer
Integer numbers.
- sectionType: string
_title - propertyType: anything
Name
- Type: array object[]shorts
- itemsType: array object[]
- propertyType: anything
Name
- positionType: integer
Integer numbers.
- sectionType: string
_title - propertyType: anything
Name
- Type: array object[]videos
- badgesType: array string[]
- channelType: object
- propertyType: anything
Name
- descriptionType: string
- idType: string
- isType: boolean
_live - lengthType: string
- linkType: string
- positionType: integer
Integer numbers.
- publishedType: string
_time - thumbnailType: string
- titleType: string
- views
- Type: integer
Integer numbers.
- propertyType: anything
Name
- Type: anythingproperty
Name
application/json - 400
Invalid request parameters
- 401
Unauthorized / Invalid API key
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/youtube/search?engine=youtube&q=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"search_metadata": {
"id": "string",
"status": "string",
"created_at": "string",
"request_time_taken": 1,
"parsing_time_taken": 1,
"total_time_taken": 1,
"request_url": "string",
"html_url": "string",
"json_url": "string",
"additionalProperty": "anything"
},
"search_parameters": {
"additionalProperty": "anything"
},
"search_information": {
"total_results": 1,
"additionalProperty": "anything"
},
"videos": [
{
"position": 1,
"id": "string",
"title": "string",
"link": "string",
"description": "string",
"thumbnail": "string",
"published_time": "string",
"length": "string",
"views": 1,
"channel": {
"additionalProperty": "anything"
},
"is_live": true,
"badges": [
"string"
],
"additionalProperty": "anything"
}
],
"channels": [
{
"position": 1,
"id": "string",
"title": "string",
"link": "string",
"description": "string",
"thumbnail": "string",
"subscribers": "string",
"additionalProperty": "anything"
}
],
"shorts": [
{
"position": 1,
"section_title": "string",
"items": [
{
"additionalProperty": "anything"
}
],
"additionalProperty": "anything"
}
],
"sections": [
{
"position": 1,
"section_title": "string",
"items": [
{
"additionalProperty": "anything"
}
],
"additionalProperty": "anything"
}
],
"playlists": [
{
"additionalProperty": "anything"
}
],
"ads": [
{
"additionalProperty": "anything"
}
],
"pagination": {
"next_page_token": "string",
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}