> ## Documentation Index > Fetch the complete documentation index at: https://docs.upriver.ai/llms.txt > Use this file to discover all available pages before exploring further. # Personas - Citations > Retrieve citations and behavioral evidence for audience personas. Use the continuation token from the `v2/audience_insights` response. **Recommended Usage:** Set `citations_mode=async` in the audience insights request, then call this endpoint to retrieve citations separately. This keeps the initial response fast while allowing deep citation analysis. ## OpenAPI ````yaml /api-reference/openapi.json get /v2/audience_insights/{continuation_token}/citations openapi: 3.1.0 info: title: Upriver API description: >- A social insights API for ad generation platforms. It provides structured signals, like psychographics, behavioral insights, trends, and audience language, to help AI models generate relevant, higher-converting ads. version: 1.0.0 servers: - url: https://api.upriver.ai description: Production API server security: [] tags: - name: Brands - name: Products - name: Creators - name: Audience - name: Sponsorships - name: Trends - name: Breakout Topics - name: Taxonomy paths: /v2/audience_insights/{continuation_token}/citations: get: tags: - Audience summary: Personas - Citations description: >- Retrieve citations and behavioral evidence for audience personas. Use the continuation token from the `v2/audience_insights` response. **Recommended Usage:** Set `citations_mode=async` in the audience insights request, then call this endpoint to retrieve citations separately. This keeps the initial response fast while allowing deep citation analysis. operationId: get_audience_insights_citations parameters: - name: continuation_token in: path required: true schema: type: string title: Continuation Token - name: metadata_mode in: query required: false schema: anyOf: - enum: - none - basic - debug type: string - type: 'null' description: >- Metadata mode for response filtering. If not provided, uses the metadata_mode from the original request. Use 'debug' to see citation sources. title: Metadata Mode description: >- Metadata mode for response filtering. If not provided, uses the metadata_mode from the original request. Use 'debug' to see citation sources. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AudienceInsightsCitationsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' deprecated: true security: - APIKeyHeader: [] components: schemas: AudienceInsightsCitationsResponse: properties: status: type: string enum: - pending - completed - error title: Status description: The status of the citation generation task. citations: additionalProperties: $ref: '#/components/schemas/PersonaCitationData' type: object title: Citations description: >- A dictionary where keys are persona labels and values are PersonaCitationData objects containing citations and behaviors. sources: items: type: string type: array title: Sources description: List of citation sources used. supporting_evidence: additionalProperties: anyOf: - $ref: '#/components/schemas/SupportingEvidence' - type: 'null' type: object title: Supporting Evidence description: >- A dictionary where keys are persona labels and values are supporting evidence objects with real URLs from Reddit, YouTube, and Amazon. error_message: anyOf: - type: string - type: 'null' title: Error Message description: An error message if the status is 'error'. type: object required: - status title: AudienceInsightsCitationsResponse description: Response model for the async citations endpoint. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PersonaCitationData: properties: citations: items: $ref: '#/components/schemas/PersonaCitation' type: array title: Citations description: List of citations for this persona. behaviors_demonstrated: items: type: string type: array title: Behaviors Demonstrated description: >- Deduped list of key behaviors, attitudes, and psychological patterns demonstrated across the citation evidence. type: object title: PersonaCitationData description: Citation data for a single persona. SupportingEvidence: properties: reddit_posts: items: $ref: '#/components/schemas/RedditEvidence' type: array title: Reddit Posts description: >- List of 3-5 Reddit posts/comments that demonstrate this persona's behavioral traits, each with a summary and justification type: object required: - reddit_posts title: SupportingEvidence description: |- Real-world Reddit evidence showing the persona's behavioral traits in action, with LLM justifications. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError PersonaCitation: properties: title: type: string title: Title description: Title of the cited content text: type: string title: Text description: Relevant excerpt from the citation url: anyOf: - type: string - type: 'null' title: Url description: URL of the source if available subreddit: anyOf: - type: string - type: 'null' title: Subreddit description: Subreddit if from Reddit relevance_score: type: number title: Relevance Score description: Relevance score from vector search reason: type: string title: Reason description: Succinct reason explaining why this citation supports the persona source: anyOf: - type: string - type: 'null' title: Source description: >- Source method used to find this citation. Only included in responses when metadata_mode is 'debug'. type: object required: - title - text - relevance_score - reason title: PersonaCitation description: A citation supporting persona insights. RedditEvidence: properties: title: type: string title: Title description: Title of the Reddit post summary: type: string title: Summary description: >- AI-generated summary of the Reddit discussion that captures the core message and sentiment url: type: string title: Url description: Valid URL to the Reddit post or comment subreddit: anyOf: - type: string - type: 'null' title: Subreddit description: Subreddit where this was posted justification: type: string title: Justification description: >- LLM-generated explanation of why this specific post supports the persona's behavioral traits and psychology type: object required: - title - summary - url - justification title: RedditEvidence description: Individual Reddit post/comment supporting a persona. securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ````