> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# How do I find similar Instagram creators when I only have a username?

> Start from a seed username, review recent content and choose the profile-data route needed without confusing recommendations with followers.

**Pass the username you already have to `instagram.v2.fetch_similar_users` to retrieve the accounts Instagram recommends as similar; no numeric-ID conversion is needed first.** The recommended accounts are content-discovery candidates, not the seed account's followers and not evidence of a commercial relationship.

For example, with a home-coffee creator as the seed, retrieve the recommended accounts, inspect each account's recent posts and record why each account fits the content brief.

## How do I request similar accounts with a username?

`data:instagram.v2.fetch_similar_users` accepts `username` or `user_id`; pass whichever you already know. A username is the handle, not the display name or the full profile URL:

```bash
curl --fail-with-body -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"action":"instagram.v2.fetch_similar_users","params":{"username":"<username>"}}' \
  -o instagram-similar.json
```

## How do I review the returned accounts?

The recommended accounts are at `data.data.items[]`, each with `id`, `username`, `full_name`, `is_verified`, `is_private` and `profile_pic_url`. Key the candidate list by `id`, and keep `username` for display and later checks.

1. Review each account's profile and recent work for topic, language and presentation.
2. Save two relevant content links and the review date, and write down the proposed content fit.
3. List the audience, availability or pricing questions that need further research before you contact the account.

`data.data.count` is the number of returned accounts, not a follower count. Save the `is_verified` and `is_private` markers as returned, and judge collaboration fit from evidence. `instagram.v2.fetch_similar_users` has no next-page input, so review the returned set before requesting anything else.

Suppose the seed creator makes videos about city commuting. Two recommended creators post outfits: one regularly films actual commutes, the other mainly covers formal events. Shortlist the commuter account with a representative post, and save the formal-events account for a different project.

## Should I use `instagram.v2.fetch_similar_users` or `creator.discover`?

| Need                                           | Route                                                       |
| ---------------------------------------------- | ----------------------------------------------------------- |
| A set of platform-suggested account identities | `data:instagram.v2.fetch_similar_users`, billed per request |
| Creator candidates with available profile data | `data:creator.discover`, billed per delivered creator       |

For `data:creator.discover`, `limit:3` requests three similar creators, and the seed may come back as an additional row. A successful empty result is billed at the one-unit minimum. Estimate cost from the current [pricing page](https://beatapi.io/pricing) and the applicable unit, not from the final shortlist size.

The [candidate-review guide](/guides/instagram-creator-shortlist) exports both sources locally with IDs, sources and manual selection reasons. Choose one route for the current round, and reuse saved responses. The candidate table does not send emails or messages.

[Instagram task directory](/guides/instagram)