Skip to main content
POST
/
v1
/
brand
/
product
Product Details
curl --request POST \
  --url https://api.upriver.ai/v1/brand/product \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "brand_name": "Nike",
  "product_name": "Air Max 270",
  "product_url": "https://nike.com/air-max-270",
  "effort": "low"
}
'
{
  "name": "<string>",
  "description": "<string>",
  "features": [
    "<string>"
  ],
  "specifications": {},
  "price": "<string>",
  "currency": "<string>",
  "reviews_summary": "<string>",
  "alternatives": [
    "<string>"
  ],
  "images": [
    "<string>"
  ]
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Input model for detailed product research endpoint.

​
brand_name
string
required

The brand name

Example:

"Nike"

​
product_name
string
required

The product name

Example:

"Air Max 270"

​
product_url
string | null

The specific product page URL (optional, but recommended for accuracy)

Example:

"https://nike.com/air-max-270"

​
effort
enum<string>
default:low

Effort level: 'low' (basic details), 'high' (includes competitive info)

Available options:
auto,
low,
mid,
high
Example:

"low"

Response

Successful Response

Response model for detailed product research.

​
name
string
required

Official product name

​
description
string
required

Detailed product description

​
features
string[]

Key features

​
specifications
Specifications · object

Technical specifications

​
price
string | null

Price information

​
currency
string | null

Currency code

​
reviews_summary
string | null

Summary of reviews

​
alternatives
string[]

Alternative products (high effort only)

​
images
string[]

Product images