> ## Documentation Index > Fetch the complete documentation index at: https://docs.clipstake.com/llms.txt > Use this file to discover all available pages before exploring further. # Audience geography, age and gender ## OpenAPI ````yaml /openapi.json get /users/{username}/audience openapi: 3.1.0 info: title: Pulse API description: Instagram media tracking, audience geography and demographics, as an API. version: 0.0.0 servers: - url: https://api.clipstake.com/v1 security: [] paths: /users/{username}/audience: get: tags: - Users summary: Audience geography, age and gender operationId: users-audience parameters: - in: path name: username schema: type: string minLength: 1 maxLength: 255 required: true - in: query name: as_of schema: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ responses: '200': description: Successful response content: application/json: schema: type: object properties: username: type: string availability: type: string enum: - not_tracked - pending - unavailable - available as_of: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ - type: 'null' countries: type: array items: type: object properties: bucket: type: string share_bps: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - bucket - share_bps additionalProperties: false age: type: array items: type: object properties: bucket: type: string share_bps: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - bucket - share_bps additionalProperties: false gender: type: array items: type: object properties: bucket: type: string share_bps: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - bucket - share_bps additionalProperties: false required: - username - availability - as_of - countries - age - gender additionalProperties: false example: username: acme.studio availability: available as_of: '2026-09-14T00:00:00.000Z' countries: - bucket: US share_bps: 3420 - bucket: GB share_bps: 1280 - bucket: CA share_bps: 940 - bucket: AU share_bps: 610 age: - bucket: 18-24 share_bps: 3180 - bucket: 25-34 share_bps: 4120 - bucket: 35-44 share_bps: 1460 gender: - bucket: FEMALE share_bps: 5480 - bucket: MALE share_bps: 4380 - bucket: UNKNOWN share_bps: 140 '400': description: Invalid input data content: application/json: schema: $ref: '#/components/schemas/error.BAD_REQUEST' example: error: code: invalid_request message: The request body or parameters are invalid. request_id: req_01K5A7N8QY2M4C6V9X3J '401': description: Authorization not provided content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' example: error: code: unauthorized message: Provide a valid API key. request_id: req_01K5A7P2CH8T6R4W9M1B '403': description: Insufficient access content: application/json: schema: $ref: '#/components/schemas/error.FORBIDDEN' example: error: code: forbidden message: This API key does not have access to this resource. request_id: req_01K5A7Q3NB6D8F2H4V9T '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/error.NOT_FOUND' example: error: code: not_found message: The requested resource was not found. request_id: req_01K5A7R4WM9C2N6B8X3D '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR' example: error: code: internal_error message: An unexpected error occurred. request_id: req_01K5A7S6FQ3V8H2N9C4M security: - Authorization: [] components: schemas: error.BAD_REQUEST: type: object properties: message: type: string description: The error message example: Invalid input data code: type: string description: The error code example: BAD_REQUEST issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Invalid input data error (400) description: The error information example: code: BAD_REQUEST message: Invalid input data issues: [] error.UNAUTHORIZED: type: object properties: message: type: string description: The error message example: Authorization not provided code: type: string description: The error code example: UNAUTHORIZED issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Authorization not provided error (401) description: The error information example: code: UNAUTHORIZED message: Authorization not provided issues: [] error.FORBIDDEN: type: object properties: message: type: string description: The error message example: Insufficient access code: type: string description: The error code example: FORBIDDEN issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Insufficient access error (403) description: The error information example: code: FORBIDDEN message: Insufficient access issues: [] error.NOT_FOUND: type: object properties: message: type: string description: The error message example: Not found code: type: string description: The error code example: NOT_FOUND issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Not found error (404) description: The error information example: code: NOT_FOUND message: Not found issues: [] error.INTERNAL_SERVER_ERROR: type: object properties: message: type: string description: The error message example: Internal server error code: type: string description: The error code example: INTERNAL_SERVER_ERROR issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false title: Internal server error error (500) description: The error information example: code: INTERNAL_SERVER_ERROR message: Internal server error issues: [] securitySchemes: Authorization: type: http scheme: bearer ````