> ## Documentation Index
> Fetch the complete documentation index at: https://starcovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns

> Turn a goal into a managed shortlist: create, generate matches, augment, operate, and export.

A campaign is the primary product object. It carries a goal, generates creator matches against that goal, and holds the shortlist you augment and operate. Campaigns work the same from the web, MCP, REST, and CLI.

All campaign endpoints require a credential: an agent access token, a Settings API key, or a browser session. See [Authentication](/docs/authentication).

## The loop

<Steps>
  <Step title="Create with a goal">
    ```bash theme={null}
    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"}'
    ```
  </Step>

  <Step title="Generate matches">
    ```bash theme={null}
    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.
  </Step>

  <Step title="Augment">
    Add or remove individual matches with `POST /api/campaigns/{id}/matches` and `DELETE /api/campaigns/{id}/matches/{matchId}`.
  </Step>

  <Step title="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`).
  </Step>
</Steps>

Every endpoint is in the [API reference](/docs/api-reference/list-campaigns) 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.

## CLI equivalents

```bash theme={null}
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
```