Traction Graph

Trends

Traction Graph

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

Server:https://api.upriver.ai

Production API server

Authentication

Selected Auth Type: APIKeyHeader

Name : Clear Value

Value : Show Password

Client Libraries

Shell

Ruby

Node.js

PHP

Python

MoreSelect from all clients

Shell Curl

Traction Graph

​Copy link

Auth Required

Pre-computed traction graph points for a trend. Returns both 'all' and 'recent' windows with estimated curves plus separate blended activity curves.

Path Parameters

• trend_idCopy link to trend_id

  Type: string · Trend Id

  required

Query Parameters

• metadata_modeCopy link to metadata_mode

  Type: string · Metadata Mode

  Default

  basic

  Pattern

  ^(basic|debug)$

  How much traction metadata to include. 'basic' returns only precomputed series; 'debug' also returns raw evidence and diagnostics.

Responses

• 200

  Traction graph with all and recent windows

  application/json
• 422

  Validation Error

  application/json

Request Example for get/v2/trends/{trend_id}/traction

Shell Curl

curl 'https://api.upriver.ai/v2/trends/{trend_id}/traction' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

cURLCopy

cURLCopy

Test Request(get /v2/trends/{trend_id}/traction)

Status: 200Status: 422

Show Schema

null

Traction graph with all and recent windows