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.
Find the most relevant categories from the taxonomy for a given freeform text. Useful for discovering the best category for brand industries, target audiences, etc. Returns ordered matches with confidence scores.
Input for category search endpoint.
Freeform text to match against category taxonomy
Number of categories to return, ordered by relevance
curl https://api.upriver.ai/v1/categories/search \
--request POST \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_SECRET_TOKEN' \
--data '{
"text": "telehealth and men'\''s health",
"top_k": 5
}'
{
"matches": [
{
"category_id": "string",
"display_name": "string",
"level": 1,
"parent_id": "string",
"confidence": 0,
"reason": "string"
}
],
"query_text": "string"
}