Skip to content
UpriverUpriverUpriver API Docs

Personas - Citations

v1.0.0
OpenAPI 3.1.0

Upriver API

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.

Server:https://api.upriver.ai

Production API server

Client Libraries
Shell Curl
deprecated

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.

Path Parameters
  • continuation_token
    Type: string · Continuation Token
    required
Query Parameters
  • metadata_mode
    Type: string · Metadata Modeenumnullable

    Metadata mode for response filtering. If not provided, uses the metadata_mode from the original request. Use 'debug' to see citation sources.

    values
    • none
    • basic
    • debug
Responses
  • application/json
  • application/json
Request Example for get/v2/audience_insights/{continuation_token}/citations
curl 'https://api.upriver.ai/v2/audience_insights/{continuation_token}/citations' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "status": "pending",
  "citations": {
    "additionalProperty": {
      "citations": [
        {
          "title": "string",
          "text": "string",
          "url": "string",
          "subreddit": "string",
          "relevance_score": 1,
          "reason": "string",
          "source": "string"
        }
      ],
      "behaviors_demonstrated": [
        "string"
      ]
    }
  },
  "sources": [
    "string"
  ],
  "supporting_evidence": {
    "additionalProperty": {
      "reddit_posts": [
        {
          "title": "string",
          "summary": "string",
          "url": "string",
          "subreddit": "string",
          "justification": "string"
        }
      ]
    }
  },
  "error_message": "string"
}

Successful Response