YouTube Get Search Suggestions
## YouTube search suggestions Get autocomplete phrases similar to those shown when typing in the YouTube search box. ### Inputs - `keyword` (required): Search keyword, up to 200 characters. - `language` (optional): Language code; defaults to `en`. Examples: `en` (English), `zh-cn` (Simplified Chinese), `ja` (Japanese), `ko` (Korean). - `region` (optional): Region code; defaults to `US`. Examples: `US` (United States), `SG` (Singapore), `CN` (China), `JP` (Japan), `KR` (South Korea). ### Returned data - `keyword`: The search keyword. - `suggestions`: An array of suggested search phrases. - `total_count`: The number of suggestions returned. Suggestions depend on language and region. These are autocomplete phrases, not video results or keyword search-volume statistics. Example: `{"keyword":"Rick Astley","language":"en","region":"US"}`.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
region | string | No | 地区代码/Region code (e.g., US, SG, CN, JP) | US |
keyword | string | Yes | 搜索关键词/Search keyword | — |
language | string | No | 语言代码/Language code (e.g., en, zh-cn, ja) | en |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_youtube_get_search_suggestions' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "xxx"
}
}'No response example available yet.

