# Quick starts

> Copy-and-paste Public API V1 examples for finding media kits, social accounts, decks, and campaigns.
>
> Canonical URL: https://docs.creatorsjet.com/api/quick-starts

These examples are read-only: they do not change your CreatorsJet account. They are a good first test after you create an API key.

> **Info — No code? Use MCP instead:**
>
> If you are working in an AI assistant, use the [MCP quick starts](/mcp/quick-starts). This page is only for people using a terminal or building software.

## Before you start

If a developer has given you an API key, set it once in the terminal they told you to use:

```bash
export CREATORSJET_API_KEY="paste-your-api-key-here"
```

Replace sample IDs with IDs returned by CreatorsJet. Keep the API key private; never paste it into a website, spreadsheet, or chat message.

## List your media kits

Creator keys return the creator's visible media kits. Agency keys return kits owned by the agency.

```bash
curl "https://api.creatorsjet.com/public/v1/media-kits?limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

An agency can limit the result to one roster creator:

```bash
curl "https://api.creatorsjet.com/public/v1/media-kits?creator_id=66b0f51d46071dc43b2db103&limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

This needs the `media_kits:read` scope.

## List connected social accounts

A creator key lists the connected social accounts for the creator represented by the key:

```bash
curl "https://api.creatorsjet.com/public/v1/socials?limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

An agency key must specify a creator already in its roster. This example returns only that creator's Instagram accounts:

```bash
curl "https://api.creatorsjet.com/public/v1/socials?creator_id=66b0f51d46071dc43b2db103&platform=instagram&limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

Creator keys need `profile:read`; agency keys need `roster:read`. Results include a platform, username, profile URL, and connection status—never OAuth credentials.

## List agency pitch decks

Pitch decks belong to agencies:

```bash
curl "https://api.creatorsjet.com/public/v1/decks?limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

This needs `decks:read`.

## List active campaigns

Creator and agency keys can list their own campaigns:

```bash
curl "https://api.creatorsjet.com/public/v1/campaigns?status=active&limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

Remove `status=active` to return all campaigns. This needs `campaigns:read`.

## Read the result and get the next page

Every list returns a `data` array. When there are more results, the response also includes `meta.next_cursor`. Copy that value unchanged into the next request:

```bash
curl "https://api.creatorsjet.com/public/v1/campaigns?limit=10&cursor=PASTE_NEXT_CURSOR_HERE" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

If a request returns `403`, check that the API key has the listed scope. A `404` for a resource means it is not visible to that key.