> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# Get creator audience and performance

> Compare source-specific audience and performance reports, preserving population, denominator and actual observation window. Missing required parts are partial delivery.

The request and response panels use the schemas published by this API. Conditional requirements and allowed combinations are part of the request schema. Check the complete schema before combining filters or identities.

## Billing

| Input | Price unit | Price (USD) |
| - | - | - |
| /input/platform = bilibili | Per successful request | 0.02 |
| /input/platform = douyin | Per successful request | 0.0134 |
| /input/platform = instagram | Per successful request | 1.828 |
| /input/platform = onlyfans | Per successful request | 1.5947 |
| /input/platform = tiktok | Per successful request | 2.9947 |
| /input/platform = twitch | Per successful request | 1.5947 |
| /input/platform = twitter | Per successful request | 1.5947 |
| /input/platform = xiaohongshu | Per successful request | 0.1334 |
| /input/platform = youtube | Per successful request | 1.5947 |

Only the listed values are priced; other values do not fall back to the catalog base price.
Successful delivery is charged; a normal empty result is not charged.

Obtain an input-specific quote by sending the same request with `X-AISA-Cost-Mode: quote`; quoting neither executes the Task nor reserves funds. Execution reserves the estimated request charge and settles under the rules above. Use `X-AISA-Max-Price-USD` to cap the price.

Use an `Idempotency-Key` when executing a Task. For errors, inspect `error.code`, `error.request_id`, `error.retryable` and `error.retry_hint`. A reconciliation hint requires checking the existing request before retrying; do not assume a pending settlement is a refund.


## OpenAPI

````yaml tasks/openapi.json POST /v1/tasks/creators.get_audience
openapi: 3.1.0
info:
  title: AIsa Tasks
  version: '1'
  x-aisa-runtime-release:
    artifact_revision: 79833298e5347cbf6f763bc9313cec8dbb21b3f99e3e4bff89628c9bd47f8bed
    compiler_revision: 66257d5d26817f3e6eddc90b34155367d96513e9
    source_digest: cde7dca0fddbeccf0b89ef7580ab640c42058405baae9a3a6854c95c7c2a370e
    generation: 15127
servers:
  - url: https://api.aisa.one
security:
  - bearer: []
paths:
  /v1/tasks/creators.get_audience:
    post:
      tags:
        - Tasks
      summary: Get creator audience and performance
      description: >-
        Compare source-specific audience and performance reports, preserving
        population, denominator and actual observation window. Missing required
        parts are partial delivery.
      operationId: task_creators.get_audience
      parameters:
        - name: Idempotency-Key
          in: header
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/creators.get_audience_request'
      responses:
        '200':
          description: Successful delivery or a normal empty result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/creators.get_audience_response'
        default:
          description: Error; use the returned HTTP status and retry guidance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/creators.get_audience_error'
components:
  schemas:
    creators.get_audience_request:
      $ref: '#/components/schemas/creators.get_audience_request.12_Request'
      $schema: https://json-schema.org/draft/2020-12/schema
      x-aisa-runtime-rules:
        exactly_one:
          - - profile_url
            - handle
            - native_id
        requires:
          id_namespace:
            - native_id
          native_id:
            - id_namespace
    creators.get_audience_response:
      $ref: '#/components/schemas/creators.get_audience_response.12_Response'
      $schema: https://json-schema.org/draft/2020-12/schema
      x-aisa-runtime-rules:
        exactly_one:
          - - profile_url
            - handle
            - native_id
        requires:
          id_namespace:
            - native_id
          native_id:
            - id_namespace
    creators.get_audience_error:
      $ref: '#/components/schemas/creators.get_audience_error.0_Error'
      $schema: https://json-schema.org/draft/2020-12/schema
    creators.get_audience_request.12_Request:
      additionalProperties: false
      properties:
        input:
          $ref: '#/components/schemas/creators.get_audience_request.11_Input'
        options:
          anyOf:
            - additionalProperties: false
              properties:
                detail:
                  anyOf:
                    - enum:
                        - ''
                        - full
                      type: string
                    - type: 'null'
                max_providers:
                  anyOf:
                    - maximum: 8
                      minimum: 0
                      type: integer
                    - type: 'null'
                providers:
                  anyOf:
                    - additionalProperties: false
                      properties:
                        exclude:
                          anyOf:
                            - items:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              type: array
                            - type: 'null'
                        only:
                          anyOf:
                            - items:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              type: array
                            - type: 'null'
                      type: object
                    - type: 'null'
                strategy:
                  anyOf:
                    - enum:
                        - ''
                        - compare
                      type: string
                    - type: 'null'
              type: object
            - type: 'null'
      required:
        - input
      type: object
    creators.get_audience_response.12_Response:
      additionalProperties: false
      allOf:
        - else:
            properties:
              meta:
                properties:
                  delivered:
                    const: false
              result:
                type: 'null'
          if:
            properties:
              status:
                enum:
                  - found
                  - partial
          then:
            properties:
              meta:
                properties:
                  delivered:
                    const: true
              result:
                $ref: '#/components/schemas/creators.get_audience_response.13_Result'
        - if:
            properties:
              status:
                enum:
                  - found
            required:
              - status
          then:
            properties:
              result:
                properties:
                  by_source:
                    items:
                      properties:
                        status:
                          enum:
                            - found
                            - not_found
                      required:
                        - status
      properties:
        meta:
          additionalProperties: false
          properties:
            approximate_fields:
              items:
                type: string
              type:
                - array
                - 'null'
            delivered:
              type: boolean
            missing_fields:
              additionalProperties:
                description: >-
                  A stable missing-field reason, or distinct reasons separated
                  by '; '. Unrecognized internal diagnostics are reported as
                  unspecified.
                pattern: >-
                  ^(not_returned|not_supported|unparseable|continuation_failed|reference_identity_unverifiable|page_limit_reached|report_part_failed|some_account_identities_unusable|pagination_not_reported|page_or_item_limit_reached|some_distributions_unusable|quote_not_usable|quote_availability_not_returned|quote_price_not_returned|unspecified)(;
                  (not_returned|not_supported|unparseable|continuation_failed|reference_identity_unverifiable|page_limit_reached|report_part_failed|some_account_identities_unusable|pagination_not_reported|page_or_item_limit_reached|some_distributions_unusable|quote_not_usable|quote_availability_not_returned|quote_price_not_returned|unspecified))*$
                type: string
              type:
                - object
                - 'null'
          required:
            - missing_fields
            - approximate_fields
            - delivered
          type: object
        result:
          anyOf:
            - $ref: '#/components/schemas/creators.get_audience_response.13_Result'
            - type: 'null'
        status:
          enum:
            - found
            - partial
            - not_found
          type: string
        task:
          const: creators.get_audience
        version:
          const: 1
      required:
        - task
        - version
        - status
        - result
        - meta
      type: object
    creators.get_audience_error.0_Error:
      additionalProperties: false
      properties:
        error:
          $ref: '#/components/schemas/creators.get_audience_error.1_ErrorDetail'
      required:
        - error
      type: object
    creators.get_audience_request.11_Input:
      additionalProperties: false
      allOf:
        - oneOf:
            - properties:
                profile_url:
                  not:
                    type: 'null'
              required:
                - profile_url
            - properties:
                handle:
                  not:
                    type: 'null'
              required:
                - handle
            - properties:
                native_id:
                  not:
                    type: 'null'
              required:
                - native_id
        - if:
            properties:
              id_namespace:
                not:
                  type: 'null'
            required:
              - id_namespace
          then:
            allOf:
              - properties:
                  native_id:
                    not:
                      type: 'null'
                required:
                  - native_id
        - if:
            properties:
              native_id:
                not:
                  type: 'null'
            required:
              - native_id
          then:
            allOf:
              - properties:
                  id_namespace:
                    not:
                      type: 'null'
                required:
                  - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - instagram
            required:
              - platform
          then:
            properties:
              handle:
                anyOf:
                  - pattern: ^@?[A-Za-z0-9._]+$
                    type: string
                  - type: 'null'
              profile_url:
                anyOf:
                  - format: uri
                    not:
                      pattern: >-
                        ^https://(www\.)?instagram\.com/(p|reel|reels|stories|explore|accounts|direct)/?$
                    pattern: ^https://(www\.)?instagram\.com/[A-Za-z0-9._]+/?$
                    type: string
                  - type: 'null'
        - if:
            properties:
              platform:
                enum:
                  - instagram
            required:
              - platform
          then:
            properties:
              id_namespace:
                anyOf:
                  - enum:
                      - instagram.user
                    type: string
                  - type: 'null'
        - if:
            properties:
              platform:
                enum:
                  - tiktok
            required:
              - platform
          then:
            properties:
              handle:
                anyOf:
                  - pattern: ^@?[A-Za-z0-9._]+$
                    type: string
                  - type: 'null'
              profile_url:
                anyOf:
                  - format: uri
                    pattern: ^https://(www\.)?tiktok\.com/@[A-Za-z0-9._]+/?$
                    type: string
                  - type: 'null'
        - if:
            properties:
              platform:
                enum:
                  - tiktok
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    native_id:
                      not:
                        type: 'null'
                  required:
                    - native_id
              - not:
                  properties:
                    id_namespace:
                      not:
                        type: 'null'
                  required:
                    - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - youtube
            required:
              - platform
          then:
            properties:
              handle:
                anyOf:
                  - pattern: ^@?[A-Za-z0-9._-]+$
                    type: string
                  - type: 'null'
              profile_url:
                anyOf:
                  - format: uri
                    pattern: >-
                      ^https://(www\.)?youtube\.com/(@[A-Za-z0-9._-]+|channel/UC[A-Za-z0-9_-]+)/?$
                    type: string
                  - type: 'null'
        - if:
            properties:
              platform:
                enum:
                  - youtube
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    native_id:
                      not:
                        type: 'null'
                  required:
                    - native_id
              - not:
                  properties:
                    id_namespace:
                      not:
                        type: 'null'
                  required:
                    - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - twitter
            required:
              - platform
          then:
            properties:
              handle:
                anyOf:
                  - pattern: ^@?[A-Za-z0-9_]+$
                    type: string
                  - type: 'null'
              profile_url:
                anyOf:
                  - format: uri
                    not:
                      pattern: >-
                        ^https://(www\.)?(twitter\.com|x\.com)/(home|explore|search|i|settings|intent|share|login)/?$
                    pattern: ^https://(www\.)?(twitter\.com|x\.com)/[A-Za-z0-9_]+/?$
                    type: string
                  - type: 'null'
        - if:
            properties:
              platform:
                enum:
                  - twitter
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    native_id:
                      not:
                        type: 'null'
                  required:
                    - native_id
              - not:
                  properties:
                    id_namespace:
                      not:
                        type: 'null'
                  required:
                    - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - twitch
            required:
              - platform
          then:
            properties:
              handle:
                anyOf:
                  - pattern: ^@?[A-Za-z0-9_]+$
                    type: string
                  - type: 'null'
              profile_url:
                anyOf:
                  - format: uri
                    not:
                      pattern: >-
                        ^https://(www\.)?twitch\.tv/(directory|downloads|jobs|settings|search|videos)/?$
                    pattern: ^https://(www\.)?twitch\.tv/[A-Za-z0-9_]+/?$
                    type: string
                  - type: 'null'
        - if:
            properties:
              platform:
                enum:
                  - twitch
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    native_id:
                      not:
                        type: 'null'
                  required:
                    - native_id
              - not:
                  properties:
                    id_namespace:
                      not:
                        type: 'null'
                  required:
                    - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - onlyfans
            required:
              - platform
          then:
            properties:
              handle:
                anyOf:
                  - pattern: ^@?[A-Za-z0-9._]+$
                    type: string
                  - type: 'null'
              profile_url:
                anyOf:
                  - format: uri
                    not:
                      pattern: >-
                        ^https://(www\.)?onlyfans\.com/(my|login|signup|terms|privacy)/?$
                    pattern: ^https://(www\.)?onlyfans\.com/[A-Za-z0-9._]+/?$
                    type: string
                  - type: 'null'
        - if:
            properties:
              platform:
                enum:
                  - onlyfans
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    native_id:
                      not:
                        type: 'null'
                  required:
                    - native_id
              - not:
                  properties:
                    id_namespace:
                      not:
                        type: 'null'
                  required:
                    - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - douyin
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    profile_url:
                      not:
                        type: 'null'
                  required:
                    - profile_url
              - not:
                  properties:
                    handle:
                      not:
                        type: 'null'
                  required:
                    - handle
        - if:
            properties:
              platform:
                enum:
                  - douyin
            required:
              - platform
          then:
            properties:
              id_namespace:
                anyOf:
                  - enum:
                      - douyin.user
                      - douyin.sec_uid
                      - xingtu.kol
                    type: string
                  - type: 'null'
            required:
              - native_id
              - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - xiaohongshu
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    profile_url:
                      not:
                        type: 'null'
                  required:
                    - profile_url
              - not:
                  properties:
                    handle:
                      not:
                        type: 'null'
                  required:
                    - handle
        - if:
            properties:
              platform:
                enum:
                  - xiaohongshu
            required:
              - platform
          then:
            properties:
              id_namespace:
                anyOf:
                  - enum:
                      - xiaohongshu.user
                    type: string
                  - type: 'null'
            required:
              - native_id
              - id_namespace
        - if:
            properties:
              platform:
                enum:
                  - bilibili
            required:
              - platform
          then:
            allOf:
              - not:
                  properties:
                    profile_url:
                      not:
                        type: 'null'
                  required:
                    - profile_url
              - not:
                  properties:
                    handle:
                      not:
                        type: 'null'
                  required:
                    - handle
        - if:
            properties:
              platform:
                enum:
                  - bilibili
            required:
              - platform
          then:
            properties:
              id_namespace:
                anyOf:
                  - enum:
                      - bilibili.mid
                    type: string
                  - type: 'null'
            required:
              - native_id
              - id_namespace
        - if:
            properties:
              id_namespace:
                enum:
                  - instagram.user
                  - douyin.user
                  - xingtu.kol
                  - xingtu.author
                  - bilibili.mid
            required:
              - id_namespace
          then:
            properties:
              native_id:
                pattern: ^[1-9][0-9]*$
                type: string
      properties:
        handle:
          anyOf:
            - description: >-
                Account handle, not a display name or URL; choose exactly one of
                profile_url, handle or native_id.
              maxLength: 256
              pattern: \S
              type: string
            - type: 'null'
        id_namespace:
          anyOf:
            - description: >-
                Namespace of native_id; must be paired with native_id and match
                the selected platform.
              enum:
                - instagram.user
                - douyin.user
                - douyin.sec_uid
                - xingtu.kol
                - xiaohongshu.user
                - bilibili.mid
              type: string
            - type: 'null'
        native_id:
          anyOf:
            - description: >-
                Native account ID as a string in the paired id_namespace;
                accepted namespaces depend on platform.
              maxLength: 256
              pattern: \S
              type: string
            - type: 'null'
        platform:
          description: >-
            Platform of the creator account; determines the supported identity
            forms.
          enum:
            - instagram
            - tiktok
            - youtube
            - twitter
            - twitch
            - onlyfans
            - douyin
            - xiaohongshu
            - bilibili
          type: string
        profile_url:
          anyOf:
            - description: >-
                HTTPS account profile URL on the selected platform; choose
                exactly one of profile_url, handle or native_id.
              maxLength: 2048
              pattern: \S
              type: string
            - type: 'null'
      required:
        - platform
      type: object
    creators.get_audience_response.13_Result:
      additionalProperties: false
      properties:
        by_source:
          contains:
            properties:
              status:
                enum:
                  - found
                  - partial
            required:
              - status
          items:
            additionalProperties: false
            allOf:
              - else:
                  properties:
                    result:
                      type: 'null'
                if:
                  properties:
                    status:
                      enum:
                        - found
                        - partial
                  required:
                    - status
                then:
                  properties:
                    result:
                      allOf:
                        - $ref: >-
                            #/components/schemas/creators.get_audience_response.1_CreatorAudienceReport
                        - allOf:
                            - anyOf:
                                - properties:
                                    demographics:
                                      properties:
                                        distributions:
                                          minItems: 1
                                          minProperties: 1
                                          not:
                                            type: 'null'
                                          pattern: \S
                                      required:
                                        - distributions
                                      type: object
                                  required:
                                    - demographics
                                  type: object
                                - properties:
                                    engagement:
                                      properties:
                                        metrics:
                                          minItems: 1
                                          minProperties: 1
                                          not:
                                            type: 'null'
                                          pattern: \S
                                      required:
                                        - metrics
                                      type: object
                                  required:
                                    - engagement
                                  type: object
                        - properties:
                            lookup_status:
                              enum:
                                - found
                          required:
                            - lookup_status
              - if:
                  properties:
                    status:
                      enum:
                        - found
                  required:
                    - status
                then:
                  properties:
                    result:
                      properties:
                        coverage:
                          properties:
                            demographics:
                              const: complete
                            engagement:
                              const: complete
                        demographics:
                          properties:
                            population:
                              const: followers
                          type: object
                        engagement:
                          type: object
              - if:
                  properties:
                    status:
                      enum:
                        - partial
                  required:
                    - status
                then:
                  properties:
                    result:
                      not:
                        properties:
                          coverage:
                            properties:
                              demographics:
                                const: complete
                              engagement:
                                const: complete
                          demographics:
                            properties:
                              population:
                                const: followers
                            type: object
                          engagement:
                            type: object
            properties:
              result:
                anyOf:
                  - $ref: >-
                      #/components/schemas/creators.get_audience_response.1_CreatorAudienceReport
                  - type: 'null'
              status:
                enum:
                  - found
                  - partial
                  - not_found
                  - failed
                type: string
            required:
              - status
              - result
            type: object
          type: array
      required:
        - by_source
      type: object
    creators.get_audience_error.1_ErrorDetail:
      additionalProperties: false
      else:
        properties:
          retryable:
            const: false
      if:
        properties:
          retry_hint:
            const: after_delay
      properties:
        code:
          enum:
            - invalid_request
            - invalid_input
            - unsupported_route
            - unsupported_capability
            - unsupported_identity
            - provider_rejected_input
            - invalid_cost_mode
            - cost_quote_payment_unsupported
            - cost_quote_unsupported
            - unpriced_request_value
            - missing_api_key
            - invalid_api_key
            - api_key_disabled
            - expired_api_key
            - unauthorized
            - forbidden
            - user_disabled
            - ip_not_allowed
            - api_key_access_denied
            - estimated_price_exceeds_max_price
            - insufficient_api_key_balance
            - insufficient_wallet_balance
            - task_not_found
            - endpoint_not_found
            - request_in_progress
            - request_already_completed
            - idempotency_conflict
            - request_id_conflict
            - request_too_large
            - method_not_allowed
            - rate_limit_exceeded
            - internal_error
            - service_unavailable
          type: string
        message:
          type: string
        param:
          type: string
        problems:
          items:
            type: string
          type: array
        request_id:
          minLength: 1
          type: string
        retry_hint:
          enum:
            - never
            - after_delay
            - reconcile_first
          type: string
        retryable:
          type: boolean
        similar_tasks:
          items:
            type: string
          type: array
        task_id:
          type: string
      required:
        - code
        - message
        - request_id
        - retryable
        - retry_hint
      then:
        properties:
          retryable:
            const: true
      type: object
    creators.get_audience_response.1_CreatorAudienceReport:
      additionalProperties: false
      allOf:
        - if:
            properties:
              coverage:
                properties:
                  demographics:
                    enum:
                      - complete
                      - partial
                required:
                  - demographics
          then:
            properties:
              demographics:
                type: object
        - if:
            properties:
              coverage:
                properties:
                  demographics:
                    enum:
                      - not_supported
                      - not_returned
                required:
                  - demographics
          then:
            properties:
              demographics:
                type: 'null'
        - if:
            properties:
              coverage:
                properties:
                  engagement:
                    enum:
                      - complete
                      - partial
                required:
                  - engagement
          then:
            properties:
              engagement:
                type: object
        - if:
            properties:
              coverage:
                properties:
                  engagement:
                    enum:
                      - not_supported
                      - not_returned
                required:
                  - engagement
          then:
            properties:
              engagement:
                type: 'null'
        - if:
            properties:
              coverage:
                properties:
                  demographics:
                    enum:
                      - complete
                required:
                  - demographics
          then:
            properties:
              demographics:
                properties:
                  population:
                    const: followers
      properties:
        coverage:
          $ref: >-
            #/components/schemas/creators.get_audience_response.0_CreatorAudienceCoverage
        creator:
          $ref: '#/components/schemas/creators.get_audience_response.8_CreatorSummary'
        demographics:
          anyOf:
            - $ref: >-
                #/components/schemas/creators.get_audience_response.3_CreatorDemographics
            - type: 'null'
        engagement:
          anyOf:
            - $ref: >-
                #/components/schemas/creators.get_audience_response.5_CreatorEngagement
            - type: 'null'
        lookup_status:
          enum:
            - found
            - private
            - not_found
            - unavailable
          type: string
      required:
        - creator
        - lookup_status
        - coverage
        - demographics
        - engagement
      type: object
    creators.get_audience_response.0_CreatorAudienceCoverage:
      additionalProperties: false
      properties:
        demographics:
          enum:
            - complete
            - partial
            - not_supported
            - not_returned
          type: string
        engagement:
          enum:
            - complete
            - partial
            - not_supported
            - not_returned
          type: string
      required:
        - demographics
        - engagement
      type: object
    creators.get_audience_response.8_CreatorSummary:
      additionalProperties: false
      properties:
        avatar_url:
          anyOf:
            - type: string
            - type: 'null'
        display_name:
          anyOf:
            - type: string
            - type: 'null'
        follower_count:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
        identity:
          $ref: >-
            #/components/schemas/creators.get_audience_response.6_CreatorIdentity
      required:
        - identity
        - display_name
        - avatar_url
        - follower_count
      type: object
    creators.get_audience_response.3_CreatorDemographics:
      additionalProperties: false
      properties:
        distributions:
          items:
            $ref: >-
              #/components/schemas/creators.get_audience_response.4_CreatorDistribution
          minItems: 1
          type: array
        population:
          enum:
            - followers
            - viewers
            - unspecified
          type: string
        window:
          $ref: '#/components/schemas/creators.get_audience_response.9_CreatorWindow'
      required:
        - population
        - window
        - distributions
      type: object
    creators.get_audience_response.5_CreatorEngagement:
      additionalProperties: false
      properties:
        formula:
          anyOf:
            - type: string
            - type: 'null'
        metrics:
          contains:
            properties:
              value:
                type: number
            required:
              - value
          items:
            $ref: >-
              #/components/schemas/creators.get_audience_response.7_CreatorMetric
          minItems: 1
          type: array
        sample_count:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
        usable_sample_count:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
        window:
          $ref: '#/components/schemas/creators.get_audience_response.9_CreatorWindow'
      required:
        - window
        - sample_count
        - usable_sample_count
        - metrics
        - formula
      type: object
    creators.get_audience_response.6_CreatorIdentity:
      additionalProperties: false
      allOf:
        - else:
            properties:
              id_namespace:
                type: 'null'
          if:
            properties:
              native_id:
                type: string
          then:
            properties:
              id_namespace:
                minLength: 1
                type: string
      anyOf:
        - properties:
            native_id:
              minLength: 1
              type: string
        - properties:
            handle:
              minLength: 1
              type: string
        - properties:
            profile_url:
              minLength: 1
              type: string
      properties:
        handle:
          anyOf:
            - pattern: \S
              type: string
            - type: 'null'
        id_namespace:
          anyOf:
            - pattern: \S
              type: string
            - type: 'null'
        native_id:
          anyOf:
            - pattern: \S
              type: string
            - type: 'null'
        platform:
          enum:
            - instagram
            - tiktok
            - youtube
            - twitter
            - twitch
            - onlyfans
            - douyin
            - xiaohongshu
            - bilibili
            - facebook
            - snapchat
            - pinterest
            - linkedin
            - discord
          type: string
        profile_url:
          anyOf:
            - format: uri
              type: string
            - type: 'null'
      required:
        - platform
        - native_id
        - id_namespace
        - handle
        - profile_url
      type: object
    creators.get_audience_response.4_CreatorDistribution:
      additionalProperties: false
      properties:
        buckets:
          items:
            $ref: >-
              #/components/schemas/creators.get_audience_response.2_CreatorBucket
          minItems: 1
          type: array
        dimension:
          enum:
            - age
            - gender
            - country
            - province
            - city
          type: string
      required:
        - dimension
        - buckets
      type: object
    creators.get_audience_response.9_CreatorWindow:
      additionalProperties: false
      properties:
        days:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
        end:
          anyOf:
            - type: string
            - type: 'null'
        kind:
          enum:
            - snapshot
            - rolling
            - calendar
            - recent_posts
            - lifetime
            - unknown
          type: string
        label:
          anyOf:
            - type: string
            - type: 'null'
        start:
          anyOf:
            - type: string
            - type: 'null'
        timezone:
          anyOf:
            - type: string
            - type: 'null'
      required:
        - kind
        - start
        - end
        - days
        - timezone
        - label
      type: object
    creators.get_audience_response.7_CreatorMetric:
      additionalProperties: false
      allOf:
        - if:
            properties:
              name:
                enum:
                  - engagement_rate
            required:
              - name
          then:
            properties:
              unit:
                enum:
                  - ratio
            required:
              - unit
        - if:
            not:
              properties:
                name:
                  enum:
                    - engagement_rate
              required:
                - name
          then:
            properties:
              unit:
                enum:
                  - count
            required:
              - unit
        - if:
            not:
              properties:
                name:
                  enum:
                    - followers_gained
              required:
                - name
          then:
            properties:
              value:
                minimum: 0
      properties:
        aggregation:
          anyOf:
            - enum:
                - mean
                - median
                - total
                - snapshot
              type: string
            - type: 'null'
        denominator:
          anyOf:
            - type: string
            - type: 'null'
        name:
          enum:
            - engagement_rate
            - likes_per_post
            - comments_per_post
            - views_per_post
            - follower_count
            - followers_gained
            - views
            - likes
            - comments
            - shares
          type: string
        unit:
          enum:
            - count
            - ratio
          type: string
        value:
          anyOf:
            - type: number
            - type: 'null'
      required:
        - name
        - value
        - unit
        - aggregation
        - denominator
      type: object
    creators.get_audience_response.2_CreatorBucket:
      additionalProperties: false
      anyOf:
        - properties:
            ratio:
              not:
                type: 'null'
          required:
            - ratio
        - properties:
            count:
              not:
                type: 'null'
          required:
            - count
      properties:
        count:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
        key:
          type: string
        label:
          anyOf:
            - type: string
            - type: 'null'
        ratio:
          anyOf:
            - maximum: 1
              minimum: 0
              type: number
            - type: 'null'
      required:
        - key
        - label
        - ratio
        - count
      type: object
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.