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.
Get metadata about available verticals and categories for filtering.
Returns the taxonomy of verticals and their associated categories, with human-readable display names for building filter UIs.
curl https://api.upriver.ai/v1/topics/breakout/metadata \
--header 'X-API-Key: YOUR_SECRET_TOKEN'
{
"verticals": [
{
"id": "string",
"name": "string",
"categories": [
{
"id": "string",
"name": "string"
}
]
}
]
}