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"
}