Skip to content
UpriverUpriverUpriver API Docs

List valid filter values (Beta)

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

List valid filter values (Beta)

​

Filters are exact-match; this is how callers learn legal values (e.g. the persona key is teacher, not teachers).

Responses
  • application/json
Request Example for get/v2/radar/facets
curl https://api.upriver.ai/v2/radar/facets \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "beta": "Beta: response shapes may change and this surface may converge with /v2/trends.",
  "types": [
    "string"
  ],
  "programs": [
    {
      "value": "string",
      "label": "string",
      "count": 1
    }
  ],
  "lifecycle_states": [
    {
      "value": "string",
      "label": "string",
      "count": 1
    }
  ],
  "personas": [
    {
      "value": "string",
      "label": "string",
      "count": 1
    }
  ],
  "brand_safety": [
    {
      "value": "string",
      "label": "string",
      "count": 1
    }
  ],
  "sorts": [
    "string"
  ]
}

Successful Response