API Documentation

YouTube Autocomplete API

Get localized YouTube search suggestions for a query.

Test API

Endpoint

GET https://api.goanyapi.com/api/v1/youtube-autocomplete

With the current configuration, each successful request costs 3 credits.

Request parameters

ParameterTypeRequiredDefaultDescription
qstringYesNon-blank query, up to 200 characters
hlstringNoenSuggestion language, for example en or zh-CN
glstringNoUSTwo-letter country code, for example US or CN
GET /api/v1/youtube-autocomplete?q=ai&hl=zh-CN&gl=US
Authorization: Bearer YOUR_API_KEY

Response

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "youtube-autocomplete",
    "remainingCredits": 996,
    "query": { "q": "ai", "hl": "zh-cn", "gl": "US" },
    "suggestions": ["ai engineer", "ai shorts", "ai video"]
  }
}

data.costCredits is the credits consumed by this request. Empty results and failed or invalid requests cost 0 credits. Suggestions remain in returned order.