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.
- 列挙値engine定数: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"
}