Skip to content
UpriverUpriverUpriver API Docs

Media Categories

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

Media Categories

​

Returns the media categories split into L1 (top-level) and L2 (second-level) lists. These categories can be used as a filter for sponsors, sponsorships. and other endpoints which support filtering by categories.

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

{
  "l1": [
    {
      "category_id": "string",
      "display_name": "string",
      "level": 1,
      "parent_id": "string",
      "description": "string",
      "aliases": [
        "string"
      ]
    }
  ],
  "l2": [
    {
      "category_id": "string",
      "display_name": "string",
      "level": 1,
      "parent_id": "string",
      "description": "string",
      "aliases": [
        "string"
      ]
    }
  ]
}

Successful Response