Skip to content
UpriverUpriverUpriver API Docs

Get one radar item with live stats (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

Get one radar item with live stats (Beta)

​
Path Parameters
  • item_id
    Type: string · Item Id
    required
Responses
  • application/json
  • application/json
Request Example for get/v2/radar/items/{item_id}
curl 'https://api.upriver.ai/v2/radar/items/{item_id}' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "beta": "Beta: response shapes may change and this surface may converge with /v2/trends.",
  "item": {
    "id": "string",
    "type": "trend_moment",
    "name": "string",
    "description": "string",
    "insight": "string",
    "how_to_act": "string",
    "brand_safety": "string",
    "lifecycle_state": "string",
    "momentum_ratio": 1,
    "value_score": 1,
    "stats": {
      "additionalProperty": "anything"
    },
    "personas": [
      {
        "additionalProperty": "anything"
      }
    ],
    "program": "string",
    "first_seen": "2026-11-06T03:35:49.599Z",
    "last_updated": "2026-11-06T03:35:49.599Z",
    "archived": false
  }
}

Successful Response