Track sellers - Seller Assistant API

Starts to track the seller of a seller page or a storefront URL. The body is one object or an array of them. Each new seller counts against the plan limit of the tracked sellers, and the team can add at most this limit of sellers on one day. Seller Assistant reads the storefront in the background: is_processing is true until the first read ends.

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 application/jsonRequired

Example

{
    "url": "https://www.amazon.com/s?me=A1B2C3D4E5F6G7&marketplaceID=ATVPDKIKX0DER"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

One result for each element. An array answers this shape. A refused element is null in data, and errors gives the reason at the same index.

Bodyapplication/json

Example

{
    "data": [
        {
            "id": 12,
            "seller_id": "A1B2C3D4E5F6G7",
            "marketplace_id": "ATVPDKIKX0DER",
            "name": "Acme Goods",
            "seller_url": "https://www.amazon.com/sp?marketplaceID=ATVPDKIKX0DER&seller=A1B2C3D4E5F6G7",
            "storefront_url": "https://amazon.com/s?me=A1B2C3D4E5F6G7&marketplaceID=ATVPDKIKX0DER",
            "rating": 97,
            "rating_count": 1250,
            "stars": 4.8,
            "products_count": 340,
            "products_added_30d": 12,
            "new_brands_30d": 2,
            "is_processing": false,
            "seller_type": {
                "classified": true,
                "is_amazon": false,
                "brand_sells_itself": false,
                "is_distributor": true
            },
            "tracked_since": "2026-04-22",
            "snapshot_at": "2026-10-23T07:00:32Z"
        }
    ],
    "meta": {
        "succeeded": 2,
        "failed": 1
    },
    "errors": [
        {
            "code": "not_found",
            "message": "The product [P-1] was not found."
        }
    ]
}

🟢201

🟠400BadRequest

🟠402PaymentRequired

🟠403AccessDenied

🟠409Conflict

🟠422BusinessLogicError

🟠429TooManyRequests