Example requests
Copy-and-paste, read-only requests for listing media kits, social accounts, decks, and campaigns.
These examples only read data. They do not change your CreatorsJet account, which makes them a safe first test after you create an API key.
Working in an AI assistant?
Use the MCP example requests instead. This page is for a terminal or your own code.
Before you start
Set the key once in your terminal session:
export CREATORSJET_API_KEY="paste-your-api-key-here"Replace sample IDs with IDs returned by CreatorsJet. Keep the 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"Requires media_kits:read.
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 name 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. OAuth credentials are never returned.
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"Requires decks:read.
List active campaigns
Agency keys can list their agency's 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. Requires campaigns:read.
Get the next page
Every list returns a data array. When there are more results, the response also includes meta.next_cursor. Pass that value unchanged in 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 something fails
| Status | What it usually means |
|---|---|
401 | The key is missing, malformed, expired, or revoked. |
403 | The key does not have the scope listed above, or the plan is no longer eligible. |
404 | The resource is not visible to this key. |
See errors for the full list of codes.