> ## Documentation Index > Fetch the complete documentation index at: https://docs.launchpointhq.com/llms.txt > Use this file to discover all available pages before exploring further. # View creator audience demographics > Get saved audience demographics for each linked social account of a visible creator. Percentages use a `0` to `100` scale, including `usAudiencePercentage`. Audience data can be up to about 30 days old; `lastUpdatedAt` is a Unix timestamp in milliseconds for the newest data in that account block. `countries` comes from the monthly country refresh when available and falls back to the Instagram account's own country split otherwise. `usAudiencePercentage` is populated only from the monthly country refresh, so null does not mean the US share is zero. A saved no-data marker can return `0`; that does not prove the US share is zero. `reason` is set only when the entire audience block has no data. When country data is missing but age, gender, or city data exists, `countriesReason` describes the missing country data instead. The `instagramAudiences` entries expose separate populations Meta reports: people reached, people who engaged, and followers. These are different sets of people, so do not add them together. The possible no-data reasons are `unsupported_platform`, `no_data_marker`, and `never_fetched`. A creator the API key cannot see returns `404`. ## OpenAPI ````yaml /api-reference/openapi.json get /creators/{id}/audience openapi: 3.0.4 info: title: Launchpoint Public API version: 1.0.0 description: >- **Private preview.** The Launchpoint Public API is in private preview and available only to trusted partners we work with directly. Access is not self-serve. Email hi@launchpointhq.com to ask about access. REST API for Launchpoint brands and agencies. Use an API key in the `x-api-key` header to authenticate. ## Requirements - Public API access must be enabled for the company. During private preview, access is limited to trusted partners. - Create and manage API keys in Dashboard → Settings → Developer. ## Creator privacy - Responses never include creator email addresses. Creator phone numbers are null when no number is stored or the workspace does not have access to creator contact details. ## Rate limits - Default: **100 requests per minute** per API key. - Approved partner accounts: **400 requests per minute**. - Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`. Requests over the limit return `429`. ## Errors - Errors use `{ "error": "" }` with the matching HTTP status. Some endpoints also include a `code`. ## Timestamps - Timestamps are Unix timestamps in milliseconds unless a field says otherwise. ## Pagination - Most list endpoints accept `page` and `limit` and return `{ data, page, total }`. Some also return `totalPages`. - `scope=company` is the default. A parent agency key can pass `scope=agency` on supported routes to include its own data and linked brands. servers: - url: https://dashboard.launchpointhq.com/api/v1 description: Live API server security: - apiKeyAuth: [] tags: - name: Deals description: Public creator opportunities across Launchpoint - name: Programs description: Programs and campaign management - name: Posts description: Posts and social content - name: Analytics description: KPIs and performance metrics - name: Payouts description: Payouts, balances, and pending creator funds - name: Contracts description: Contracts and creator agreements - name: Creators description: Creator profiles and metrics - name: Applications description: Creator applications to Canvas programs - name: Messages description: Read and send creator messages paths: /creators/{id}/audience: get: tags: - Creators summary: View creator audience demographics description: > Get saved audience demographics for each linked social account of a visible creator. Percentages use a `0` to `100` scale, including `usAudiencePercentage`. Audience data can be up to about 30 days old; `lastUpdatedAt` is a Unix timestamp in milliseconds for the newest data in that account block. `countries` comes from the monthly country refresh when available and falls back to the Instagram account's own country split otherwise. `usAudiencePercentage` is populated only from the monthly country refresh, so null does not mean the US share is zero. A saved no-data marker can return `0`; that does not prove the US share is zero. `reason` is set only when the entire audience block has no data. When country data is missing but age, gender, or city data exists, `countriesReason` describes the missing country data instead. The `instagramAudiences` entries expose separate populations Meta reports: people reached, people who engaged, and followers. These are different sets of people, so do not add them together. The possible no-data reasons are `unsupported_platform`, `no_data_marker`, and `never_fetched`. A creator the API key cannot see returns `404`. parameters: - $ref: '#/components/parameters/ScopeParam' - in: path name: id required: true schema: type: string description: Opaque creator ID responses: '200': description: Audience demographics returned successfully content: application/json: schema: type: object properties: creatorId: type: string data: type: array items: $ref: '#/components/schemas/CreatorAudienceAccount' example: creatorId: crt_demo_creator_7x2 data: - platform: instagram handle: demo_creator lastUpdatedAt: 1786089600000 audience: status: available reason: null countriesReason: null usAudiencePercentage: 72 countries: - label: US percentage: 72 - label: GB percentage: 18 - label: CA percentage: 10 ages: - label: 25-34 percentage: 48.5 genders: - label: female percentage: 61.2 cities: - label: New York percentage: 12.4 demographicsBasis: reached sampleSize: 2500 instagramAudiences: - basis: reached sampleSize: 2500 countries: - label: US percentage: 72 - label: GB percentage: 18 - label: CA percentage: 10 ages: - label: 25-34 percentage: 48.5 genders: - label: female percentage: 61.2 cities: - label: New York percentage: 12.4 - basis: engaged sampleSize: 840 countries: - label: US percentage: 68 - label: GB percentage: 22 - label: CA percentage: 10 ages: - label: 25-34 percentage: 52.1 genders: - label: female percentage: 58.7 cities: - label: New York percentage: 14.1 - basis: followers sampleSize: 3100 countries: - label: US percentage: 70 - label: GB percentage: 20 - label: CA percentage: 10 ages: - label: 25-34 percentage: 47.9 genders: - label: female percentage: 62.4 cities: - label: New York percentage: 11.8 - platform: tiktok handle: null lastUpdatedAt: 1786003200000 audience: status: no_data reason: no_data_marker countriesReason: no_data_marker usAudiencePercentage: null countries: [] ages: [] genders: [] cities: [] demographicsBasis: null sampleSize: null instagramAudiences: [] '400': description: Creator ID is invalid '401': description: Unauthorized - API key is invalid '403': description: The requested scope is not allowed '404': description: Creator was not found or is not visible to this API key '429': description: Request rate limit exceeded '500': description: Server error components: parameters: ScopeParam: in: query name: scope required: false schema: type: string enum: - company - agency default: company description: >- Choose the data scope. `company` (default) limits results to the API key company's data. `agency` includes the parent agency and its linked brands. `scope=agency` requires a parent agency key; other keys receive `403`. schemas: CreatorAudienceAccount: type: object properties: platform: type: string handle: type: string nullable: true lastUpdatedAt: type: integer nullable: true description: >- Unix timestamp in milliseconds; audience data may be up to about 30 days old audience: $ref: '#/components/schemas/CreatorAudienceBlock' CreatorAudienceBlock: type: object properties: status: type: string enum: - available - no_data reason: type: string nullable: true enum: - unsupported_platform - no_data_marker - never_fetched countriesReason: type: string nullable: true enum: - unsupported_platform - no_data_marker - never_fetched usAudiencePercentage: type: number nullable: true description: >- US audience percentage from the monthly country refresh only; null does not mean zero. A saved no-data marker can return 0; that does not prove the US share is zero. sampleSize: type: integer nullable: true description: >- Number of people behind the returned country distribution, or null when the saved source has percentages without counts countries: type: array description: >- Country distribution from the monthly country refresh when available, or the Instagram account's own country split when no monthly geo row exists. items: $ref: '#/components/schemas/AudienceDistribution' ages: type: array items: $ref: '#/components/schemas/AudienceDistribution' genders: type: array items: $ref: '#/components/schemas/AudienceDistribution' cities: type: array items: $ref: '#/components/schemas/AudienceDistribution' demographicsBasis: type: string nullable: true enum: - reached - followers instagramAudiences: type: array description: >- Separate Instagram populations reported by Meta: people reached, people who engaged, and followers. These are different sets of people and should not be added together. items: $ref: '#/components/schemas/InstagramAudience' AudienceDistribution: type: object properties: label: type: string percentage: type: number InstagramAudience: type: object properties: basis: type: string enum: - reached - engaged - followers sampleSize: type: integer nullable: true description: >- Number of people behind the country distribution, or null when the source has percentages without counts countries: type: array items: $ref: '#/components/schemas/AudienceDistribution' ages: type: array items: $ref: '#/components/schemas/AudienceDistribution' genders: type: array items: $ref: '#/components/schemas/AudienceDistribution' cities: type: array items: $ref: '#/components/schemas/AudienceDistribution' securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: API key created in Dashboard → Settings → Developer ````