Endpoint Playground

Try the Suggest YouTube search queries API

Returns YouTube search-box autocomplete completions for a query prefix, in YouTube's own ranking order. `hl` and `gl` localize the list; they default to `en` and `US`.

What a live request returned

14 Oct 2026: 14 suggestions; 2 fields had a value in every checked item.

Observed request: GET /youtube/suggest?q=openai&count=20
Fields with a value in every checked item: position, query

Sample value profiles: position: 1 to 14, median 7.

Request: GET /youtube/suggest
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.90 s
Monitored request: GET /youtube/suggest?q=openai

Suggest YouTube search queries API documentation YouTube platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/youtube/suggest?q=openai" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	Yes	openai	Search query prefix
count	integer	No		Suggestions to return; defaults to 10, clamped to 1..20
hl	string	No		YouTube interface language, such as en, de, or pt-BR; defaults to en
gl	string	No		Two-letter YouTube region code; defaults to US

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "openai",
    "suggestions": [
      {
        "position": 1,
        "query": "openai"
      },
      {
        "position": 2,
        "query": "openai dev day"
      },
      {
        "position": 3,
        "query": "openai sora"
      }
    ]
  }
}

More YouTube endpoints

Retrieve auto-generated or human captions Retrieve the playlists tab for a YouTube channel Search within a YouTube channel Retrieve the shorts tab for a YouTube channel Retrieve the videos tab for a YouTube channel Retrieve video comments (top-level & replies)Retrieve playlist metadata and items Retrieve channel profile Search YouTube Retrieve YouTube videos by tag Retrieve transcript for a YouTube video List transcript languages for a YouTube video All 14 YouTube endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestyoutube.suggestResponseDocYouTube

GET /youtube/suggest

Suggest YouTube search queries

Returns YouTube search-box autocomplete completions for a query prefix, in YouTube's own ranking order. `hl` and `gl` localize the list; they default to `en` and `US`.

Response behavior

- A prefix with no completions returns a valid empty `suggestions` array, not an error. - A malformed `hl` or `gl` returns `400`; YouTube silently ignores a well-formed code it does not support. - The endpoint tries YouTube's own suggest host and falls back to Google's `ds=yt` suggest host, so a block on one host does not fail the call.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Search query prefix

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

youtube_suggest

MCP auth

Authorization: Bearer $CRAWLORA_API_KEY

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "openai",
    "suggestions": [
      {
        "position": 1,
        "query": "openai"
      },
      {
        "position": 2,
        "query": "openai dev day"
      },
      {
        "position": 3,
        "query": "openai sora"
      }
    ]
  }
}

Endpoint Playground

Try the Suggest YouTube search queries API

Returns YouTube search-box autocomplete completions for a query prefix, in YouTube's own ranking order. `hl` and `gl` localize the list; they default to `en` and `US`.

What a live request returned

14 Oct 2026: 14 suggestions; 2 fields had a value in every checked item.

Observed request: GET /youtube/suggest?q=openai&count=20
Fields with a value in every checked item: position, query

Sample value profiles: position: 1 to 14, median 7.

Request: GET /youtube/suggest
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.90 s
Monitored request: GET /youtube/suggest?q=openai

Suggest YouTube search queries API documentation YouTube platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/youtube/suggest?q=openai" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	Yes	openai	Search query prefix
count	integer	No		Suggestions to return; defaults to 10, clamped to 1..20
hl	string	No		YouTube interface language, such as en, de, or pt-BR; defaults to en
gl	string	No		Two-letter YouTube region code; defaults to US

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "openai",
    "suggestions": [
      {
        "position": 1,
        "query": "openai"
      },
      {
        "position": 2,
        "query": "openai dev day"
      },
      {
        "position": 3,
        "query": "openai sora"
      }
    ]
  }
}

More YouTube endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestyoutube.suggestResponseDocYouTube

GET /youtube/suggest

Suggest YouTube search queries

Returns YouTube search-box autocomplete completions for a query prefix, in YouTube's own ranking order. `hl` and `gl` localize the list; they default to `en` and `US`.

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Search query prefix

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

youtube_suggest

MCP auth

Authorization: Bearer $CRAWLORA_API_KEY

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "openai",
    "suggestions": [
      {
        "position": 1,
        "query": "openai"
      },
      {
        "position": 2,
        "query": "openai dev day"
      },
      {
        "position": 3,
        "query": "openai sora"
      }
    ]
  }
}