List product retailers
Retrieve the retailer regions supported for product discovery.
/v1/product-retailersLists the retailer regions you can use to scope product category
discovery. Pass a returned retailer's id (e.g. amazon_us,
walmart_us) as the retailer query parameter on
list product categories.
Authorization
bearerAuth Short-lived access token issued by Create a token.
Send it on every request as Authorization: Bearer <token>.
In: header
Response Body
application/json
curl -X GET "https://ext.vizit.com/v1/product-retailers"[ { "id": "amazon_us", "retailer": "amazon", "region": "us", "display_name": "Amazon US", "domain": "amazon.com" }]GETList product categories
Lists the product categories your organization has ICP access to. Use a returned category's `id` as the `product_category_id` when you [submit a PDP by id](/api/product-details/upsertPdpById) or [submit an image for scoring](/api/images/scoreImage). Not required for ASIN ingestion — category is derived from the retailer scrape. Pass the optional `retailer` query parameter to scope the results to a single retailer region.
GETRetrieve PDP scores by id
Returns the current scores and processing state for a PDP submitted via [Submit a PDP by id](/api/product-details/upsertPdpById). Poll until `status` reaches a terminal `COMPLETED` or `ERROR`. While `status` is `PROCESSING`, including during a rescore, the score fields are `null` until the new scores land. `score_method` tells you whether `pdp_score` is a `FORMULA` score, broken down in `score_breakdown`, or a `LEGACY` score. See [How the score is computed](/guides/how-the-score-is-computed) for how to read the breakdown. Use the optional `retailer` query parameter to disambiguate the same id submitted under different retailers. The `score_url` returned by the PUT already includes it.