Campaigns

The loop

Create with a goal

curl -X POST "https://www.starcovery.com/api/campaigns" \
  -H "x-api-key: <access_token>" \
  -H "content-type: application/json" \
  -d '{"name": "Coffee", "goal": "quiet morning coffee creators who film at home"}'

Generate matches

curl -X POST "https://www.starcovery.com/api/campaigns/{id}/generate" \
  -H "x-api-key: <access_token>"

Generation runs searches against the campaign goal and lands ranked creators on the campaign.

Augment

Add or remove individual matches with POST /api/campaigns/{id}/matches and DELETE /api/campaigns/{id}/matches/{matchId}.

Operate

Read the campaign with matches (GET /api/campaigns/{id}), update it (PATCH /api/campaigns/{id}), or export the shortlist as CSV (GET /api/campaigns/{id}/export).

Every endpoint is in the API reference with an interactive playground.

Visibility and cost

New campaigns are public by default. Public campaign bodies are free to read for any identified caller.

The owner always reads their own campaigns free.

Private campaigns are invisible to non-owners (404). Anonymous callers get 401.

Making a campaign private costs 1 credit: at creation, or when flipping public to private. Updates to an already-private campaign do not charge again.

starcovery campaign starcovery campaign create "Coffee" --goal "quiet morning coffee creators" starcovery campaign generate <id> starcovery campaign show <id> starcovery campaign export <id> > out.csv

Get started

Guides

The loop

Visibility and cost

CLI equivalents

​The loop

​Visibility and cost

​CLI equivalents

The loop

Visibility and cost

CLI equivalents