GET /api/amazon/seller — Amazon Seller Profile

The /api/amazon/seller endpoint returns a seller’s full profile from any supported Amazon marketplace — including their display name, logo, phone number, aggregate rating, and a paginated list of their active product listings. Use this endpoint to power seller directory pages, due-diligence tools, or competitive-analysis dashboards.

Request

GET https://api.glade.dev/api/amazon/seller

string

required

The Amazon seller identifier for the seller you want to look up. You can find this value in a seller’s Amazon profile URL — it appears as the seller query parameter, e.g. amazon.com/sp?seller=A2L77EE7U53NWQ.

string

default:"US"

The Amazon marketplace to query. Accepted values: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL. Defaults to US when omitted.

integer

The page number of the seller’s product listings to return. Must be 1 or greater. Omit to retrieve the first page.

Response

A successful response returns data.amazonSeller.

object

Show amazonSeller

string

The unique Amazon seller identifier.

string

The seller’s display name as shown on their Amazon storefront.

string

URL of the seller’s logo image, if available.

string

The seller’s listed contact phone number, if provided.

number

The seller’s aggregate feedback rating, on a scale of 1–5.

string

The seller’s self-written about/description text from their storefront.

object

Show productResults

array

Show results[]

string

Product title.

string

Canonical Amazon product URL.

string

Amazon Standard Identification Number.

object

Show price

string

Currency symbol, e.g. "$".

number

Numeric price value, e.g. 35.99.

string

ISO 4217 currency code, e.g. "USD".

string

Formatted display string, e.g. "$35.99".

string

URL of the primary product image.

number

Average customer rating (1–5).

integer

Total number of customer ratings.

boolean

Whether the product is eligible for Amazon Prime.

boolean

Whether the listing is a sponsored placement.

object | null

Active coupon object, or null if no coupon is present.

Show coupon

string

Coupon label text, e.g. "Save 5%".

object

Show pageInfo

integer

The page number returned.

integer

Total number of listing pages available.

integer

Total product listing count for this seller.

boolean

Whether a subsequent page exists.

boolean

Whether a previous page exists.

Example response

{
  "success": true,
  "data": {
    "amazonSeller": {
      "sellerId": "A2L77EE7U53NWQ",
      "name": "Anker Direct",
      "logoUrl": "https://images-na.ssl-images-amazon.com/images/S/aplus-seller-content-images-us-east-1/A2L77EE7U53NWQ/logo.png",
      "phone": "+1-800-988-7973",
      "rating": 4.7,
      "about": "Anker is one of the world's leading charging technology brands. We make products that keep your devices powered wherever you go.",
      "productResults": {
        "results": [
          {
            "title": "Anker 65W USB-C Charger, 3-Port Fast Charger",
            "url": "https://www.amazon.com/dp/B09B4XBL3W",
            "asin": "B09B4XBL3W",
            "price": {
              "symbol": "$",
              "value": 35.99,
              "currency": "USD",
              "display": "$35.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/71abc123XYZ.jpg",
            "rating": 4.8,
            "ratingsTotal": 12453,
            "isPrime": true,
            "sponsored": false,
            "coupon": { "label": "Save 5%" }
          },
          {
            "title": "Anker PowerCore 10000 Portable Charger",
            "url": "https://www.amazon.com/dp/B0194WDVHI",
            "asin": "B0194WDVHI",
            "price": {
              "symbol": "$",
              "value": 21.99,
              "currency": "USD",
              "display": "$21.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/61def456ABC.jpg",
            "rating": 4.7,
            "ratingsTotal": 98231,
            "isPrime": true,
            "sponsored": false,
            "coupon": null
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "totalPages": 24,
          "totalResults": 473,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      }
    }
  }
}

Curl example

curl --request GET \
  --url "https://api.glade.dev/api/amazon/seller?sellerId=A2L77EE7U53NWQ&domain=US&page=1" \
  --header "API-KEY: <your-api-key>"

Error handling

If a required parameter is missing or invalid, the API returns a non-2xx status code with a JSON error body. Always check the success field before reading data.

HTTP Status	Meaning
`400`	Bad request — a required parameter is missing or has an invalid value.
`401`	Unauthorized — your API key is missing or invalid.
`402`	Payment required — your plan does not cover this endpoint or your quota is exhausted.
`429`	Too many requests — you have exceeded your plan’s rate limit.
`502`	Bad gateway — Amazon returned an unexpected response; retry with exponential back-off.

Example error response

{
  "success": false,
  "errors": [
    {
      "code": 400,
      "message": "Missing required parameter: sellerId"
    }
  ]
}

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/seller — Amazon Seller Profile

Request

Response

Example response

Curl example

Error handling

Example error response

​Request

​Response

​Example response

​Curl example

​Error handling

​Example error response

Request

Response

Example response

Curl example

Error handling

Example error response