InsightSocial APISearch › Suggestions
Returns the autocomplete suggestions YouTube's own search box shows for a partial query, as a plain list of strings.
Use it for keyword research, or to expand a seed term before running search or search/advanced.
20 credits per call.
Re-running the exact same call within 1h is free.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Partial search query to autocomplete.
ISO 3166-1 alpha-2 country code to localize suggestions.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/youtube/search/suggestions?query=string"{ "success": true, "platform": "instagram", "endpoint": "/v1/instagram/profile/posts", "data": { "items": [ "…" ], "dropped": 0 }, "pagination": { "next_cursor": "is2.eyJwIjoyfQ", "has_more": true, "page_size": 12 }, "credits_used": 20, "credits_remaining": 9980, "request_id": "req_1a2b3c4d5e6f", "cached": false, "idempotent_replay": false, "charge_reason": "miss", "free_call": false}Search › Hashtag GET
Returns videos posted under a hashtag, each with view count, channel info, and publish date. Use it to read a hashtag feed rather than a keyword query; set type to shorts to limit the results to Shorts. **Metered: 20–220 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).
Search GET
Returns YouTube search results for a keyword: videos, channels, playlists, shorts, and live streams, each with title, thumbnail, views, and channel. Use it for a general keyword search across every content kind; search/advanced returns videos only but adds date, license, and country filters. **Metered: 20–380 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).