> ## 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

# 获取达人画像与表现

> 对比同一达人各来源的粉丝画像与表现，保留样本人群、分母和真实统计窗口；缺少必要部分时交付 partial。

上方请求和响应面板使用此 API 发布的 Schema。条件必填和参数组合限制属于请求契约；组合筛选条件或账号身份前，请查看完整 Schema。

## 计费

| 输入 | 计价单位 | 价格 (USD) |
| - | - | - |
| /input/platform = bilibili | 每次成功请求 | 0.02 |
| /input/platform = douyin | 每次成功请求 | 0.0134 |
| /input/platform = instagram | 每次成功请求 | 1.828 |
| /input/platform = onlyfans | 每次成功请求 | 1.5947 |
| /input/platform = tiktok | 每次成功请求 | 2.9947 |
| /input/platform = twitch | 每次成功请求 | 1.5947 |
| /input/platform = twitter | 每次成功请求 | 1.5947 |
| /input/platform = xiaohongshu | 每次成功请求 | 0.1334 |
| /input/platform = youtube | 每次成功请求 | 1.5947 |

仅表内参数值有价格；未列出的值不会回退到基础价格。
成功交付才收费；正常查空不收费。

发送相同请求并带上 `X-AISA-Cost-Mode: quote`，获取与输入对应的报价；报价不执行任务，也不预扣资金。实际执行时预扣预计请求费用，按上述规则结算。用 `X-AISA-Max-Price-USD` 设置价格上限。

执行任务时使用 `Idempotency-Key`。错误时查看 `error.code`、`error.request_id`、`error.retryable` 和 `error.retry_hint`。提示先核对结算时，应先查询原请求再决定是否重试；不能把待结算当作已退款。


## OpenAPI

````yaml zh/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:
        - 任务
      summary: 获取达人画像与表现
      description: 对比同一达人各来源的粉丝画像与表现，保留样本人群、分母和真实统计窗口；缺少必要部分时交付 partial。
      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: 成功交付或正常查空
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/creators.get_audience_response'
        default:
          description: 错误；以实际 HTTP 状态和重试指引为准
          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.