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.
- enumengineконстанта:youtubeобязательно
SearchApi engine identifier. Use
youtubefor this YouTube endpoint.значения- youtube
- Тип: stringqобязательно
Search query. Required by runtime and upstream SearchApi.
- Тип: stringsp
YouTube filter token (pagination or advanced filters)
- Тип: stringgl
Country code (e.g. us, jp)
- Тип: stringhl
Interface language
- Тип: object200
Successful YouTube search response
YouTube search result payload.
- Тип: array object[]ads
- propertyТип: anything
Name
- Тип: array object[]channels
- descriptionТип: string
- idТип: string
- linkТип: string
- positionТип: integer
Integer numbers.
- subscribersТип: string
- thumbnailТип: string
- titleТип: string
- propertyТип: anything
Name
- Тип: objectpagination
- nextТип: string
_page _token - propertyТип: anything
Name
- Тип: array object[]playlists
- propertyТип: anything
Name
- Тип: objectsearch
_information - totalТип: integer
_results Integer numbers.
- propertyТип: anything
Name
- Тип: objectsearch
_metadata - createdТип: string
_at - htmlТип: string
_url - idТип: string
- jsonТип: string
_url - parsingТип: number
_time _taken - requestТип: number
_time _taken - requestТип: string
_url - statusТип: string
- totalТип: number
_time _taken - propertyТип: anything
Name
- Тип: objectsearch
_parameters - propertyТип: anything
Name
- Тип: array object[]sections
- itemsТип: array object[]
- propertyТип: anything
Name
- positionТип: integer
Integer numbers.
- sectionТип: string
_title - propertyТип: anything
Name
- Тип: array object[]shorts
- itemsТип: array object[]
- propertyТип: anything
Name
- positionТип: integer
Integer numbers.
- sectionТип: string
_title - propertyТип: anything
Name
- Тип: array object[]videos
- badgesТип: array string[]
- channelТип: object
- propertyТип: anything
Name
- descriptionТип: string
- idТип: string
- isТип: boolean
_live - lengthТип: string
- linkТип: string
- positionТип: integer
Integer numbers.
- publishedТип: string
_time - thumbnailТип: string
- titleТип: string
- views
- Тип: integer
Integer numbers.
- propertyТип: anything
Name
- Тип: 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"
}