# YouTube Search Suggestions API (https://www.socialcrawl.dev/platforms/youtube/search-suggestions)

> Returns YouTube's search autocomplete suggestions for a partial query — the same suggestions the search box shows. Useful for keyword expansion and SEO research. Returns a string list under `items`.

TL;DR: `GET /v1/youtube/search/suggestions` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Partial search query to autocomplete. |
| `region` | no | ISO 3166-1 alpha-2 country code to localize suggestions. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/youtube/search/suggestions?query=lofi" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get YouTube search suggestions via API?

Send a GET to /v1/youtube/search/suggestions with a partial query. The response returns a string list of autocomplete terms under items, the same ones the YouTube search box shows.

### What are search suggestions good for?

They are ideal for keyword expansion and SEO research: seed a topic and see the real phrases viewers type, so you can target the terms YouTube already surfaces.

### Can I localize the suggestions?

Yes. Pass region with an ISO country code to get suggestions localized to that country's YouTube audience.

### What does the response look like?

A simple list of suggestion strings under items, easy to feed straight into a keyword tool, a content planner, or another search call.

### How much does the suggestions endpoint cost?

It is a standard endpoint at 1 credit per request, and every new account starts with 100 free credits.

See the full YouTube API: https://www.socialcrawl.dev/platforms/youtube

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get YouTube search autocomplete suggestions via API
- YouTube keyword suggestions API for SEO research