API Reference

Product Recommendation

post
https://shopping-gallery.prd-commerce.sovrnservices.com/ai-orchestration/products

This endpoint provides product recommendations tailored to your content. Pass in your content along with optional filters like price range or preferred merchants, and receive a curated list of relevant products.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Your Sovrn Commerce API key. Found in the Sovrn Platform under Site Settings or via the Campaigns API.

string

Market in the format currency_language (e.g., usd_en). Inferred from IP if not provided.

string

Custom tracking ID for associating recommendations with a specific user, session, or page.

string

Price filter using "min-max" format, e.g., "20-50" or "*-25".

string

Comma separated list of merchant IDs to include. Only one of includeMerchants or excludeMerchants may be used.

string

Comma separated list of merchant IDs to exclude. Only one of includeMerchants or excludeMerchants may be used.

integer
Defaults to 4

Number of products to return. Default: 4, Max: 50.

string
required

The URL or key of the content you want recommendations for. See the 'Caching' section above for more information.

Body Params
string

Short descriptive title for the content (optional).

string
required

The material you want to generate recommendations from. This can be full HTML from a page, plain text from an article, or even a short description of a product, user, or scenario.

Response

Updated 7 months ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago