YouTube Videocategories List

1 credits/call
ae_youtube_videocategories_list

List available YouTube video categories for a specific region.

Video
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
hlstringNoLanguage code for localized metadata (e.g., 'en', 'zh-CN'). Default varies by endpoint.—
idstringNoReturns the video categories with the given IDs for Stubby or Apiary.—
partenum (snippet)YesThe *part* parameter specifies the videoCategory resource properties that the API response will include. Set the parameter value to snippet.—
regionCodestringNoISO 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-Key
Request 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
JSONPartial content
{
  "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.