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).
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
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.
Optional keywords to search within this seller's storefront.
Result page, 1-based. metadata.total_pages says how far it goes.
Marketplace country code.
Result ordering.
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.
Lowest price, in the marketplace currency; decimals such as 19.99 are fine.
Highest price, in the marketplace currency.
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.
Brand name as Amazon spells it (case-insensitive), e.g. Samsung.
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.
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.
Changes
No recorded changes to this operation across all 1 revision of this API.