YouTube API endpoint

Search within a YouTube channel

Returns normalized video search items scoped to a specific channel, including the resolved top-level `query`.

GETapiKey3 credits/requestyoutube.channelSearchResponseDoc/youtube/channel/{id}/search

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Channel ID, @handle, /c path, /user path, or full YouTube channel URL
q	query	string	Yes	Search query
continuation_token	query	string	No	Pagination token returned by a previous request
x-api-key	header	string	Yes	API key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 3 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Catalog quality warnings

missing example for required path param: id
missing example for required query param: q

Failure responses

Status	Description	Schema
400	Missing or invalid parameters	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "gpt",
    "channel_id": "UCXZCJLdBC09xxGZ6gcdrc6A",
    "channel_title": "OpenAI",
    "handle": "@OpenAI",
    "items": [
      {
        "type": "video",
        "position": 1,
        "title": "Search Result 1",
        "video_id": "abc123xyz89",
        "duration": "04:20"
      }
    ],
    "continuation_token": "NEXT_TOKEN"
  }
}

Request schema

No body schema

Response schema

#/definitions/youtube.channelSearchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	youtube.channelSearchResponseDataDoc	No
data.channel_id	string	No	UCXZCJLdBC09xxGZ6gcdrc6A
data.channel_title	string	No	OpenAI
data.channel_url	string	No	https://www.youtube.com/@OpenAI
data.continuation_token	string	No	NEXT_TOKEN
data.handle	string	No	@OpenAI
data.items	array	No
data.items[].badges	array	No	HD,CC
data.items[].channel_id	string	No	UCXZCJLdBC09xxGZ6gcdrc6A
data.items[].channel_thumbnail	string	No	https://yt3.ggpht.com/example=s68-c-k-c0x00ffffff-no-rj
data.items[].channel_title	string	No	OpenAI
data.items[].description_snippet	string	No	A concise walkthrough of GPT features.
data.items[].duration	string	No	12:34
data.items[].duration_seconds	integer	No	754
data.items[].handle	string	No	@OpenAI
data.items[].is_live	boolean	No
data.items[].is_short	boolean	No
data.items[].is_verified	boolean	No
data.items[].playlist_id	string	No	PL1234567890abcdef
data.items[].position	integer	No	1
data.items[].published_text	string	No	2 days ago
data.items[].short_view_count	string	No	123K views
data.items[].subscriber_count	string	No	1.93M subscribers
data.items[].thumbnail	string	No	https://i.ytimg.com/vi/abc123/hq720.jpg
data.items[].title	string	No	ChatGPT Explained
data.items[].type	string	No	video
data.items[].url	string	No	https://www.youtube.com/watch?v=abc123
data.items[].video_count	string	No	9 lessons
data.items[].video_id	string	No	abc123xyz89
data.items[].view_count	string	No	123,456 views
data.query	string	No	gpt
data.thumbnail	string	No	https://yt3.googleusercontent.com/example=s176-c-k-c0x00ffffff-no-rj
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/youtube/channel/user-1/search" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/youtube/channel/user-1/search");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group