> 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.

# Creator Discovery guides

> Find Instagram creators similar to a seed account, review their work and look up public contact details for the shortlist.

To build a creator shortlist from one Instagram creator whose work fits a campaign, call `creator.discover` with that creator's handle as `seed` to get similar candidates. Review each candidate's actual posts, then call `creator.contacts` with the shortlisted handles to fill in public contact details.

## Find candidates from a seed account

Send both JSON bodies on this page to `POST https://api.beatapi.io/v1/social-data/call` with BeatAPI Bearer authentication. Replace each placeholder with a confirmed handle.

```json
{"action":"creator.discover","params":{"platform":"instagram","seed":"<confirmed_handle>","limit":3}}
```

1. Check each `handle` and `profile_url` in `data[]`.
2. If the seed account appears in `data[]`, mark the seed account as the reference account and shortlist only the other candidates.
3. For each candidate, save the posts that support the selection and note why the posts fit the brief. For a commuter-style campaign, for example, save posts about shoe weight or walking longer distances.

## Fill in public contact details for selected accounts

```json
{"action":"creator.contacts","params":{"platform":"instagram","handles":["<shortlisted_handle>"]}}
```

When contact details for the same account were already found earlier and are suitable, reuse the earlier contact details. For each shortlisted account, keep the handle, profile link, representative posts, selection reason, contact status and collection time. If `creator.contacts` returns no email, record that contact status and keep the verified profile link.

Before handoff, spot-check one row by opening the account and the post that supports the selection. Put handles from only one platform in each `creator.contacts` request. See [creator questions](/faq/creator) and [BeatAPI pricing](https://beatapi.io/pricing).