Amazon Data

Products listed by a seller

Use to list one seller's storefront. Products listed by a seller: a storefront search. Takes the same filters as search -- query, page, sort_by, category_id, min_price / max_price, product_condition, brand, today_deals, deal_type -- and answers with filters_applied, filters_ignored and available_filters like search does.

Price: $0.003 per call

Notes: A malformed seller_id is a free 400, as on seller_profile_batch. metadata.total_pages counts every page of the result (48 rows a page), but Amazon serves at most 7 pages of one query: metadata.reachable_pages is how far page can go, and when it is less, pagination_note says how to see the rest (min_price/max_price bands or category_id). _links.next is the next page while there is one; a page past the end is a free 400 page_out_of_range. Invalid sort_by, price, product_condition or deal_type is a free 400 that lists the allowed values. No single sort order lists a whole storefront: Amazon's relevance order (the default) can count far fewer products than the store holds and repeats products across pages, and other orders include products it leaves out (measured on one store: relevance 321, NEWEST 1,898; on another, relevance and NEWEST shared 90 of 161 products). Page 1 of a storefront without query carries coverage_note with the recipe: page through sort_by=RELEVANCE and sort_by=NEWEST, split a store larger than 336 products into min_price/max_price bands, dedupe by asin. An empty storefront carries note: Amazon reports 0 products for a seller with no listings on that marketplace and for an id that is not a seller alike, so check it with seller_profile_batch (_links.seller_profile). Rows have the search row shape: offers_count is null unless the card shows a count, and product_brand is null on most storefront cards (Amazon prints no brand line there; product_details has brand_name).

get/v2/seller-products

Request

  • Base URL: https://dash.apiguru.app/api/v1
  • URL: https://dash.apiguru.app/api/v1/v2/seller-products
  • Auth: one of:
    • API key in header X-API-KEY
    • API key in query parameter api_key
    • none

Query parameters

seller_idstring required

Amazon seller id whose storefront to list: 'A' followed by 9-20 letters and digits, the seller= or me= value of a storefront URL (e.g. A2A1RNLLUK3HYA). Required.

querystring

Optional keywords to search within this seller's storefront.

pageinteger

Result page, 1-based. metadata.total_pages says how far it goes.

geo'US' | 'CA' | 'DE' | 'MX' | 'UK' | 'FR' | 'IT' | 'ES' | 'AU' | 'BR' | 'IN' | 'JP' | 'NL' | 'AE' | 'PL' | 'SA' | 'SG' | 'SE' | 'TR' | 'BE' | 'IE' | 'ZA' | 'EG'

Marketplace country code.

sort_by'RELEVANCE' | 'BEST_SELLERS' | 'LOW_HIGH_PRICE' | 'HIGH_LOW_PRICE' | 'REVIEWS' | 'NEWEST'

Result ordering.

category_idstring

Amazon browse node id to restrict to, e.g. 172282 (Electronics on US). Take one from a best_sellers answer's available_subcategories, a product's category_path, or node= in an Amazon URL. Ids differ per marketplace.

min_pricenumber

Lowest price, in the marketplace currency; decimals such as 19.99 are fine.

max_pricenumber

Highest price, in the marketplace currency.

product_condition'NEW' | 'USED' | 'RENEWED'

NEW, USED or RENEWED (case-insensitive). Applied with the marketplace's own condition node; where a marketplace does not offer one, the answer's filters_ignored says so and available_filters lists what it does offer.

brandstring

Brand name as Amazon spells it (case-insensitive), e.g. Samsung.

today_dealsboolean

Only items in Today's Deals, using that marketplace's own refinement. Where a marketplace has none (amazon.fr on 2026-09-08) it is reported under filters_ignored.

deal_type'today_deals' | 'all_discounts' | 'coupons' | 'buy_more_save_more'

A specific promotion refinement: today_deals, all_discounts, coupons or buy_more_save_more. available_filters.deal_type lists the ones this marketplace has.

Response

Success.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.