YouTube Get Search Suggestions

2.07 credits/call
ae_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"}`.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
regionstringNo地区代码/Region code (e.g., US, SG, CN, JP)US
keywordstringYes搜索关键词/Search keyword—
languagestringNo语言代码/Language code (e.g., en, zh-cn, ja)en

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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.