Перейти к навигации

Creator Discovery guides

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.

{"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

{"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 and BeatAPI pricing.