API documentation
Create an API key in your account to request reviews, product details, and best seller lists. The examples below show the request format only; they do not send requests.
The standalone Data API is not available yet. Its documentation is provided for reference. You can currently collect data through MCP and your signed-in browser extension.
curl --request POST \
--url 'https://sellerside.ai/api/v1/developer/products' \
--header "Authorization: Bearer $SELLERSIDE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"asin":"<ASIN>","market":"US","async":true}'Copy this example to use in your own setup. This page does not send requests.
Authentication and headers
Authorization: Bearer <SELLERSIDE_API_KEY>
Use your SellerSide.ai API key. The key is shown only once, when you create it. You can revoke it in API key settings.
Idempotency-Key: <your-key>
Use the same idempotency key when retrying a request. Reusing the key with the same parameters returns the existing task instead of creating another one.
Three data operations
| Data | Endpoint | Parameters | Required scope |
|---|---|---|---|
| Reviews | POST /api/v1/developer/reviews | asin, market, pageCount, filterByStar, sortBy, async | api:reviews |
| Product details | POST /api/v1/developer/products | asin, market, async | api:products |
| Best seller lists | POST /api/v1/developer/best-sellers | content, market, async | api:best-sellers |
market defaults to US. Reviews support US, CA, MX, UK, DE, JP, AU, IN, EG, and AE; pageCount accepts 1–10. Use filterByStar for all ratings, a specific rating from 1 to 5 stars, or positive or critical reviews. sortBy accepts recent or helpful. Product details and best seller lists support 13 marketplaces. For product details, asin must contain 10 letters and digits. For best seller lists, enter a category keyword in content; no category node ID or page number is needed.
Results retain the data field names, types, and nested structure, including totalReviews for reviews and category, offset, and nextPage for rankings. Task status and pagination details are returned alongside the data. A null field means no value is available.
POST · Submit a task
Returns the SellerSide.ai task ID, status, and any error code. Set async: true to receive a pending task without waiting for collection to finish.
GET · Check status
/api/v1/developer/tasks/<id>
Check whether a task in your account is pending, completed, or failed.
GET · Read results
/api/v1/developer/tasks/<id>/results?page=1&size=50
Read completed results by page. The response includes results, total, and hasNextPage.
Usage limits and errors
An active paid membership is required to create keys and make requests. Accepted review tasks use one unit per requested page; product detail and ranking tasks use one unit each. Reading task status or saved results does not use additional collection units. ALLOWANCE_EXHAUSTED means your allowance has been used up. Other error codes include AUTH_REQUIRED, RATE_LIMITED, INVALID_ARGUMENT, and TASK_NOT_FOUND.