Skip to main content
GET
/
v2
/
audience_insights
/
{continuation_token}
/
citations
Insights Citations
curl --request GET \
  --url https://api.upriver.ai/v2/audience_insights/{continuation_token}/citations
{
  "status": "pending",
  "citations": {},
  "sources": [
    "<string>"
  ],
  "supporting_evidence": {},
  "error_message": "<string>"
}

Path Parameters

​
continuation_token
string
required

Query Parameters

​
metadata_mode
enum<string> | null

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

Available options:
none,
basic,
debug

Response

Successful Response

Response model for the async citations endpoint.

​
status
enum<string>
required

The status of the citation generation task.

Available options:
pending,
completed,
error
​
citations
Citations · object

A dictionary where keys are persona labels and values are PersonaCitationData objects containing citations and behaviors.

​
sources
string[]

List of citation sources used (e.g., 'serper', 'opensearch'). Helps identify which search methods were used.

​
supporting_evidence
Supporting Evidence · object

A dictionary where keys are persona labels and values are supporting evidence objects with real URLs from Reddit, YouTube, and Amazon.

​
error_message
string | null

An error message if the status is 'error'.