find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/getcims-com:getcims-com-creators-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: CIMS Creator Data Creators API
  version: 1.0.0
  description: Agent-payable HTTP API for the CIMS database of 230M+ social media creators. All endpoints support x402 (HTTP 402 + USDC on Base) and are discoverable via MPP `x-payment-info` extensions.
  contact:
    name: CIMS
    url: https://getcims.com
servers:
- url: https://data.getcims.com/functions/v1/mcp
tags:
- name: Creators
paths:
  /v1/creators:
    get:
      operationId: get_creators
      summary: Search creators
      description: Search the CIMS database of 230M+ social media creators by query string, platform, follower range, engagement, audience, and more.
      tags:
      - Creators
      parameters:
      - name: corporateId
        in: query
        required: false
        schema:
          type: string
        description: Optional corporate scope for attribution. Not required for anonymous x402 callers.
      - name: search
        in: query
        schema:
          type: string
        description: Free-text query, @handle, or profile URL.
      - name: skip
        in: query
        schema:
          type: integer
          minimum: 0
        description: Pagination offset.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment required. PAYMENT-REQUIRED contains the x402 v2 challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired payload.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not found
      x-payment-info:
      - intent: charge
        method: x402
        amount: '1.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator search ($1.00 USDC per query)
      x-payment:
        intent: charge
        method: x402
        amount: '1.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator search ($1.00 USDC per query)
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        amount: '1000000'
        price:
          amount: '1.00'
          currency: USDC
        description: CIMS creator search ($1.00 USDC per query)
  /v1/creator/posts:
    get:
      operationId: get_creator_posts
      summary: Get creator posts
      description: Returns a paginated posts collection with post IDs, public platform URLs, content formats, post timestamps, thumbnails, and media URLs. Unavailable post fields are null; mediaUrls is empty when no media is available. Explicit campaign/list/participant/task IDs take precedence over corporateId and are checked against all the authenticated account's corporates; corporateId is optional for these explicit scopes. Lists stored social posts using the get_posts reader. Anonymous x402 calls require creatorIds and can read public creator feeds. Campaign/list/participant/task, monitored/scheduled and attention scopes require CIMS Bearer authentication with get_creator_posts permission and authorized campaign/task access; payment never grants this access. corporateId selects only an authenticated account's corporate (required for multi-corporate campaign scopes). REST reads stored data without triggering credit-billed creator refreshes. Lists accept comma-separated or repeated query values.
      tags:
      - Creators
      parameters:
      - name: creatorIds
        in: query
        schema:
          type: string
        description: Comma-separated/repeated positive creator IDs for public feeds.
      - name: campaignIds
        in: query
        schema:
          type: string
        description: Comma-separated/repeated positive IDs. Requires CIMS authentication and authorized campaign/task access.
      - name: listIds
        in: query
        schema:
          type: string
        description: Comma-separated/repeated positive IDs. Requires CIMS authentication and authorized campaign/task access.
      - name: participantIds
        in: query
        schema:
          type: string
        description: Comma-separated/repeated positive IDs. Requires CIMS authentication and authorized campaign/task access.
      - name: taskIds
        in: query
        schema:
          type: string
        description: Comma-separated/repeated positive IDs. Requires CIMS authentication and authorized campaign/task access.
      - name: ids
        in: query
        schema:
          type: string
        description: Comma-separated/repeated stored post IDs.
      - name: corporateId
        in: query
        schema:
          type: string
        description: Select a corporate belonging to the authenticated account. Explicit campaign/list/participant/task IDs take precedence; otherwise required for multi-corporate campaign scopes. Not anonymous attribution.
      - name: monitored
        in: query
        schema:
          type: boolean
        description: CIMS authentication required. When either category is supplied, only categories set to true are included. At least one must be true.
      - name: scheduled
        in: query
        schema:
          type: boolean
        description: CIMS authentication required. When either category is supplied, only categories set to true are included. At least one must be true.
      - name: attention
        in: query
        schema:
          type: string
          enum:
          - todo
          - approved
          - all
        description: Task attention status computed from readable tasks. CIMS authentication required.
      - name: sort
        in: query
        schema:
          type: string
        description: Comma-separated/repeated any, date, -date, impressions, -impressions, engagements, -engagements. Last non-any value wins; default -date.
      - name: from
        in: query
        schema:
          type: string
          format: date-time
        description: Optional ISO date or datetime. Omit unless filtering to posts published on or after this date.
      - name: to
        in: query
        schema:
          type: string
          format: date-time
        description: Optional ISO date or datetime. Omit unless filtering to posts published on or before this date. Date-only values include the full day.
      - name: platforms
        in: query
        schema:
          type: string
        description: 'Legacy public creator-feed filter only (not campaign/task scopes; use postTypes there). Comma-separated or repeated platform names; any means no filter. Examples: instagram,tikTok,youTube.'
      - name: postTypes
        in: query
        schema:
          type: string
        description: 'Optional comma-separated content type filter. Omit for all post types. Examples: instagramPost,instagramReel,tikTokVideo,youTubeShorts.'
      - name: skip
        in: query
        schema:
          type: integer
          minimum: 0
        description: Optional integer pagination offset (0–2147483647). Omit for the first page.
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
        description: Optional page size. Defaults to 30. Values outside 1–100 are rejected.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment required. PAYMENT-REQUIRED contains the x402 v2 challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired payload.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not found
      x-payment-info:
      - intent: charge
        method: x402
        amount: '1.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator posts lookup ($1.00 USDC)
      x-payment:
        intent: charge
        method: x402
        amount: '1.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator posts lookup ($1.00 USDC)
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        amount: '1000000'
        price:
          amount: '1.00'
          currency: USDC
        description: CIMS creator posts lookup ($1.00 USDC)
  /v1/creator:
    get:
      operationId: get_creator
      summary: Get creator profile and headline statistics
      description: Returns a creator's profile (name, handle, follower count, verification) and the latest headline statistics. Looks up by handle+platform, or by creatorId.
      tags:
      - Creators
      parameters:
      - name: handle
        in: query
        schema:
          type: string
        description: Social handle, e.g. @username.
      - name: platform
        in: query
        schema:
          type: string
          enum:
          - instagram
          - tikTok
          - youTube
          - snapChat
          - x
          - twitch
          - linkedIn
          - pinterest
          - xiaohongshu
        description: Required when handle is provided.
      - name: creatorId
        in: query
        schema:
          type: integer
        description: Direct lookup by numeric creator id.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment required. PAYMENT-REQUIRED contains the x402 v2 challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired payload.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not found
      x-payment-info:
      - intent: charge
        method: x402
        amount: '5.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator profile + headline statistics ($5.00 USDC)
      x-payment:
        intent: charge
        method: x402
        amount: '5.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator profile + headline statistics ($5.00 USDC)
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        amount: '5000000'
        price:
          amount: '5.00'
          currency: USDC
        description: CIMS creator profile + headline statistics ($5.00 USDC)
  /v1/creator/audience:
    get:
      operationId: get_creator_audience
      summary: Get creator audience demographics
      description: 'Returns audience demographics: gender split, age distribution, audience type (real vs suspicious), location by country/city, languages, interests, brand affinity, and engagement benchmarking.'
      tags:
      - Creators
      parameters:
      - name: creatorId
        in: query
        required: true
        schema:
          type: integer
      - name: aspect
        in: query
        schema:
          type: string
          enum:
          - followers
          - commenters
          - likers
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment required. PAYMENT-REQUIRED contains the x402 v2 challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired payload.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not found
      x-payment-info:
      - intent: charge
        method: x402
        amount: '10.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator audience demographics ($10.00 USDC)
      x-payment:
        intent: charge
        method: x402
        amount: '10.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator audience demographics ($10.00 USDC)
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        amount: '10000000'
        price:
          amount: '10.00'
          currency: USDC
        description: CIMS creator audience demographics ($10.00 USDC)
  /v1/creator/statistics:
    get:
      operationId: get_creator_statistics
      summary: Get creator statistics list
      description: 'Calendar-month normalized profile history for a creator: followers, average views/likes/comments/shares/saves, view rates, engagements and stored engagement ratios. Dates are observation months, not ingestion dates. Missing measurements are explicit nulls with per-field availability; measured zero is retained.'
      tags:
      - Creators
      parameters:
      - name: creatorId
        in: query
        required: true
        schema:
          type: integer
      - name: from
        in: query
        required: false
        schema:
          type: string
        description: Observation date bound (ISO date or datetime). Date-only to includes the whole UTC day.
      - name: to
        in: query
        required: false
        schema:
          type: string
        description: Observation date bound (ISO date or datetime). Date-only to includes the whole UTC day.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment required. PAYMENT-REQUIRED contains the x402 v2 challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired payload.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not found
      x-payment-info:
      - intent: charge
        method: x402
        amount: '5.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator statistics list ($5.00 USDC)
      x-payment:
        intent: charge
        method: x402
        amount: '5.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator statistics list ($5.00 USDC)
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        amount: '5000000'
        price:
          amount: '5.00'
          currency: USDC
        description: CIMS creator statistics list ($5.00 USDC)
  /v1/creator/statistic:
    get:
      operationId: get_creator_statistic
      summary: Get a single creator statistic snapshot
      description: Latest single statistic snapshot for a creator. Missing measurements are explicit nulls with per-field availability; measured zero is retained.
      tags:
      - Creators
      parameters:
      - name: creatorId
        in: query
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment required. PAYMENT-REQUIRED contains the x402 v2 challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired payload.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not found
      x-payment-info:
      - intent: charge
        method: x402
        amount: '2.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS single creator statistic snapshot ($2.00 USDC)
      x-payment:
        intent: charge
        method: x402
        amount: '2.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS single creator statistic snapshot ($2.00 USDC)
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        amount: '2000000'
        price:
          amount: '2.00'
          currency: USDC
        description: CIMS single creator statistic snapshot ($2.00 USDC)
  /v1/creator/cpm:
    get:
      operationId: get_creator_cpm
      summary: Get creator CPM / rate-card data
      description: Returns estimated CPM rates by platform and creator-size tier. This public REST endpoint returns the unscoped rate card; campaign-specific creator CPM requires the authenticated MCP tool.
      tags:
      - Creators
      parameters:
      - name: country
        in: query
        schema:
          type: string
          minLength: 2
          maxLength: 2
        description: Optional ISO 3166-1 alpha-2 country code for currency selection.
      - name: platforms
        in: query
        schema:
          type: string
        description: Comma-separated platform filter, e.g. instagram,tikTok.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment required. PAYMENT-REQUIRED contains the x402 v2 challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired payload.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not found
      x-payment-info:
      - intent: charge
        method: x402
        amount: '5.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator CPM / rate-card data ($5.00 USDC)
      x-payment:
        intent: charge
        method: x402
        amount: '5.00'
        currency: USDC
        network: base
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        description: CIMS creator CPM / rate-card data ($5.00 USDC)
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453
        asset: USDC
        payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
        facilitator: https://api.cdp.coinbase.com/platform/v2/x402
        amount: '5000000'
        price:
          amount: '5.00'
          currency: USDC
        description: CIMS creator CPM / rate-card data ($5.00 USDC)
x-service-info:
  name: CIMS Creator Data
  categories:
  - influencer-data
  - creator-analytics
  - social-media
  docs: https://getcims.com
  mcp: https://data.getcims.com/functions/v1/mcp/mcp
  paymentMethods:
  - x402
  - tempo
  network: base
  currency: USDC
  payTo: '0xe260BB188b03832df1eBB062096089070a479ba0'
  facilitator: https://api.cdp.coinbase.com/platform/v2/x402