YouTube Videocategories List
1 credits/call
ae_youtube_videocategories_list
List available YouTube video categories for a specific region.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
hl | string | No | Language code for localized metadata (e.g., 'en', 'zh-CN'). Default varies by endpoint. | — |
id | string | No | Returns the video categories with the given IDs for Stubby or Apiary. | — |
part | enum (snippet) | Yes | The *part* parameter specifies the videoCategory resource properties that the API response will include. Set the parameter value to snippet. | — |
regionCode | string | No | ISO 3166-1 alpha-2 country code to filter content availability (e.g., 'US', 'CN'). | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_youtube_videocategories_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"part": "snippet",
"regionCode": "US"
}
}'Response exampleresponse.json
{
"etag": "QteLrrS_X7rM7rlcU_e7qa0embQ",
"items": [
{
"etag": "grPOPYEUUZN3ltuDUGEWlrTR90U",
"id": "1",
"kind": "youtube#videoCategory",
"snippet": {
"assignable": true,
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"title": "Film & Animation"
}
}
],
"kind": "youtube#videoCategoryListResponse"
}This example shows part of the response. Copied content is valid JSON.

