# Instagram Username Suggestions API (https://www.socialcrawl.dev/platforms/instagram/username-suggestions)

> Returns suggested available Instagram usernames derived from a keyword — useful for choosing a new handle. Pass a `query` keyword to seed the suggestions.

TL;DR: `GET /v1/instagram/username-suggestions` costs 5 credits 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 | Keyword to seed the username suggestions. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/instagram/username-suggestions?query=mrbeast" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Instagram username suggestions with an API?

Send a GET request to /v1/instagram/username-suggestions with the query parameter set to a keyword. SocialCrawl returns a JSON array of suggested available handles derived from that keyword.

### Are the suggested usernames available to claim?

The endpoint returns handles derived from your keyword that Instagram surfaces as available suggestions. Availability can shift, so confirm the handle on Instagram before you commit to it.

### What should I pass as the query?

Pass a brand name, niche, or keyword you want the handle to be built around. Shorter, concrete keywords tend to return cleaner, more memorable suggestions.

### Do I need the Instagram Graph API for this?

No. There is no Graph API app review, Facebook Business verification, or OAuth. A single x-api-key header authenticates the request and you call the endpoint directly.

### How much does the Instagram Username API cost?

Username suggestions is an advanced endpoint at 5 credits per request. New accounts get 100 free credits, so you can run around 20 requests before topping up.

See the full Instagram API: https://www.socialcrawl.dev/platforms/instagram

## 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 generate available Instagram username ideas with an API
- Instagram username API for picking a new handle from a keyword