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.
Provides details for a specific product including description, features, and pricing. Provide as much information as you have — more context improves accuracy.
Input:
Effort Levels:
Input model for detailed product research endpoint.
The brand's website URL.
Deprecated — brand name is now resolved automatically from the URL. This field is accepted but ignored.
The name of the product to research.
The product page URL.
Effort level: 'low' (basic details), 'high' (includes competitive info)
curl https://api.upriver.ai/v1/brand/product \
--request POST \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_SECRET_TOKEN' \
--data '{
"brand_url": "https://glossier.com",
"product_name": "Boy Brow",
"product_url": "https://www.glossier.com/products/boy-brow",
"effort": "low"
}'
{
"name": "Boy Brow",
"description": "A brushable, buildable brow gel that thickens and shapes brows. Available in 5 shades, Boy Brow uses a short bristle brush to deposit a flexible, buildable hold formula.",
"features": [
"Flexible, buildable hold",
"Short bristle brush for precise application",
"Available in 5 shades",
"Conditioning formula with cellulose and oleic acid"
],
"specifications": {
"shades": "Blond, Brown, Black, Auburn, Clear",
"size": "3.12 g / 0.11 oz",
"type": "Brow gel"
},
"price": "$18.00",
"currency": "USD",
"reviews_summary": "4.5 stars from 3,200+ reviews. Customers love the natural look and easy application.",
"alternatives": [
"Benefit Gimme Brow+",
"NYX Thick It Stick It Brow Gel"
],
"images": [
"https://www.glossier.com/cdn/images/boy-brow-brown.jpg"
]
}