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.

Before you start

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

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.

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:

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:

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:

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:

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:

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:

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.