Start a price list analysis, from a file or from already-mapped JSON items

POST

https://app.sellerassistant.app/api/v1/price-list-analyzer

Starts Price List Analyzer processing from either an xls/xlsx/csv file, or a JSON items array whose fields are already mapped. Exactly one of file or items must be provided.

File mode: if the file columns are not explicitly mapped via the mapping parameter, AI is used to automatically detect the mapping (same as the Seller Assistant dashboard). At minimum, the identifier (UPC/EAN/ASIN) and cost of goods columns must be mapped, either explicitly or by AI, otherwise a validation error is returned.

JSON items mode: send items as an array of objects, each already mapped with identifier (required) and cog (required); title, supplier_sku, price_type and supplier_case_quantity are optional. cog is the price of one unit unless price_type is case, in which case it is the price of a whole case and supplier_case_quantity is required. Requires an Amazon seller account connected for the target marketplace, since identifiers are resolved to ASINs via SP-API.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.sellerassistant.app/api/v1/price-list-analyzer?api_key=%3Capi-key%3E' \
--form 'file=@""' \
--form 'items="[{\"identifier\":\"012345678905\",\"cog\":41.00,\"title\":\"Sample Product\",\"supplier_sku\":\"SUP-123\",\"price_type\":\"case\",\"supplier_case_quantity\":12},{\"identifier\":\"612345678903\",\"cog\":14.5},{\"identifier\":\"B00U26V4VQ\",\"cog\":21.75,\"title\":\"Another Product\",\"supplier_sku\":\"SUP-456\"}]"' \
--form 'domain="amazon.com"' \
--form 'marketplaceId="ATVPDKIKX0DER"' \
--form 'description="Supplier catalog Q1"' \
--form 'mapping="{\"identifier_column\":0,\"cog_column\":2}"'

Responses

🟢201

application/json

Successful response

Bodyapplication/json

Example

{
    "id": 123,
    "status": "Created"
}

🟠400BadRequest

🟠402PaymentRequired

🟠403AccessDenied

🟠422BusinessLogicError

🟠429TooManyRequests

Modified at 2026-10-09 12:48:23

Get competitive summary for ASINs

Get price list processing status