# Overview > Connect CreatorsJet to your own software with scoped API keys. Server-to-server access to rosters, media kits, link-in-bio pages, decks, campaigns, and analytics. > > Canonical URL: https://docs.creatorsjet.com/api The CreatorsJet Public API connects CreatorsJet to your own software, website, or internal system. It is built for developers and technical teams. > **Info — Not writing code?:** > > Use [CreatorsJet MCP](/mcp) instead and ask an AI assistant in plain language. You do not need an API key for that. ## Base URL ```text https://api.creatorsjet.com/public/v1 ``` Every request is authenticated with a scoped Bearer API key. Responses are JSON, lists use opaque cursor pagination, and errors follow the `application/problem+json` format. ### [Getting started](/api/getting-started) Create an API key and make your first authenticated request. ### [Authentication](/api/authentication) Bearer keys, scopes, key lifecycle, and secret handling. ### [Endpoint reference](/api/reference) Exact requests and responses generated from the OpenAPI 3.1 contract. ## Who can use it | Account | Plan needed | What they can do | | ------- | -------------------------------- | -------------------------------------------------------------------------------------------------------- | | Creator | Active Pro or Max | Work with their own profile, media kits, social accounts, link-in-bio page, and analytics. | | Agency | Active Pro, Scale, or Enterprise | Work with roster creators, their media kits and social accounts, agency decks, campaigns, and analytics. | Only agency owners can create agency keys. API keys are private secrets: keep them on a secure server, never in a browser or public file. ## What you can do | Area | Implemented in V1 | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Creator profiles | Retrieve identity, public social accounts, summary metrics, data status, and freshness timestamps. Creator keys can retrieve only their own profile. | | Agency rosters | Add one creator, or list an agency roster with cursor pagination. | | CSV imports | Queue an import of up to 500 creator rows and retrieve row-level progress and results. | | Media kits | Ensure, list, retrieve, create, duplicate, and edit media kits: profile copy, design templates, rates, brand partners, case studies, portfolio videos, visible social statistics, and link-only or private sharing. | | Social accounts | List connected social accounts, add a handle or profile URL, or remove one. Responses never include OAuth credentials. | | Link in bio | Creator keys can create, retrieve, or edit their single page, add or remove link, title, text, image, video, or download blocks, and import a public Linktree or Beacons page. | | Deal requests | List and retrieve incoming brand deal requests, including brand contact details. | | Sponsorship matches | Creator keys can retrieve sponsorship matches for the subject. | | Pitch decks | Agency keys can list, retrieve, create, or edit agency-owned decks using creators already in the roster. | | Campaigns | Agency keys can list, retrieve, create, or edit agency-owned campaign metadata, schedules, tracking state, CPM values, and EMV override. | | Analytics | Retrieve page views, unique visitors, and a time series for owned media kits, link-in-bio pages, public rosters, decks, or campaign reports; break down traffic by referrer, country, device, browser, language, city, or OS; and read link-in-bio engagement and per-link clicks. | ### Not included in V1 V1 intentionally excludes creator-profile mutation, social OAuth and synchronization controls, campaign participants and content, campaign report configuration and lifecycle actions, deletion of media kits, decks, link-in-bio pages, or campaigns, media uploads, custom domains, the full link-in-bio designer, creator invitations, webhooks, SDKs, GraphQL, XLSX or Google Sheets imports, remote avatar ingestion, and the Find sponsors directory (available through [MCP](/mcp/tools)). ## Endpoints at a glance | Method | Endpoint | Account | Required scope | | -------- | ----------------------------------------------------------- | ------------------------ | ------------------------------------ | | `GET` | `/me` | Creator or agency | Any valid key | | `POST` | `/creators` | Agency | `roster:write` | | `GET` | `/creators` | Agency | `roster:read` | | `GET` | `/creators/{creator_id}` | Agency or creator self | `roster:read` or `profile:read` | | `POST` | `/creator-imports` | Agency | `roster:write` | | `GET` | `/creator-imports/{import_id}` | Agency | `roster:read` | | `POST` | `/media-kits` | Creator or agency | `media_kits:write` | | `POST` | `/media-kits/new` | Creator | `media_kits:write` | | `GET` | `/media-kit-templates` | Creator or agency | `media_kits:read` | | `GET` | `/media-kits` | Creator or agency | `media_kits:read` | | `GET` | `/media-kits/{media_kit_id}` | Creator or agency | `media_kits:read` | | `PATCH` | `/media-kits/{media_kit_id}` | Creator or agency | `media_kits:write` | | `PATCH` | `/media-kits/{media_kit_id}/content` | Creator or agency | `media_kits:write` | | `POST` | `/media-kits/{media_kit_id}/template` | Creator or agency | `media_kits:write` | | `POST` | `/media-kits/{media_kit_id}/items` | Creator or agency | `media_kits:write` | | `DELETE` | `/media-kits/{media_kit_id}/items/{kind}/{item_id}` | Creator or agency | `media_kits:write` | | `PUT` | `/media-kits/{media_kit_id}/socials/{social_id}/visibility` | Creator or agency | `media_kits:write` | | `POST` | `/media-kits/{media_kit_id}/duplicate` | Creator | `media_kits:write` | | `GET` | `/socials` | Creator or agency roster | `profile:read` or `roster:read` | | `POST` | `/socials` | Creator or agency roster | `media_kits:write` or `roster:write` | | `DELETE` | `/socials` | Creator or agency roster | `media_kits:write` or `roster:write` | | `GET` | `/link-in-bio` | Creator | `link_in_bio:read` | | `POST` | `/link-in-bio` | Creator | `link_in_bio:write` | | `PATCH` | `/link-in-bio` | Creator | `link_in_bio:write` | | `POST` | `/link-in-bio/blocks` | Creator | `link_in_bio:write` | | `DELETE` | `/link-in-bio/blocks/{block_id}` | Creator | `link_in_bio:write` | | `POST` | `/link-in-bio/imports` | Creator | `link_in_bio:write` | | `GET` | `/link-in-bio/imports/{import_id}` | Creator | `link_in_bio:read` | | `GET` | `/deal-requests` | Creator or agency | `deals:read` | | `GET` | `/deal-requests/{deal_id}` | Creator or agency | `deals:read` | | `GET` | `/sponsorship-matches` | Creator | `sponsorships:read` | | `GET` | `/decks` | Agency | `decks:read` | | `POST` | `/decks` | Agency | `decks:write` | | `GET` | `/decks/{deck_id}` | Agency | `decks:read` | | `PATCH` | `/decks/{deck_id}` | Agency | `decks:write` | | `GET` | `/campaigns` | Agency | `campaigns:read` | | `POST` | `/campaigns` | Agency | `campaigns:write` | | `GET` | `/campaigns/{campaign_id}` | Agency | `campaigns:read` | | `PATCH` | `/campaigns/{campaign_id}` | Agency | `campaigns:write` | | `GET` | `/analytics/views` | Creator or agency | `analytics:read` | | `GET` | `/analytics/breakdown` | Creator or agency | `analytics:read` | | `GET` | `/analytics/link-in-bio/engagement` | Creator | `analytics:read` | | `GET` | `/analytics/link-in-bio/links` | Creator | `analytics:read` | Resources that belong to another account return `404` rather than revealing that they exist. See [subjects and ownership](/api/ownership). ## Machine-readable contract The bundled OpenAPI 3.1 schema is served at [`/openapi.json`](/openapi.json). Append `.md` to any documentation URL to read that page as Markdown.