---
title: "Offers"
method: GET
path: "/v1/offers"
---

# Offers

`GET /v1/offers`

## Request

- Base URL: `https://api.logimu.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.logimu.com/v1/offers`
- Auth: none declared

LIVE Amazon offers page for one product - every offer on every page of Amazon's "All offers" view (up to 10
pages): seller, seller_id, price, shipping_cost, condition, buy box, FBA / Prime, ships-from, delivery text and
the seller's feedback - plus the buy box and the page's own header (title, image, rating, review count). No
product page is fetched: no brand, BSR, description, bullets or reviews (use /v1/product for those).

Fetched at request time - typically 4-12 s (one page ~4 s; a long list walks every page). current_sellers has the
same shape /v1/product returns (buy box first, then price ascending; buybox_days_30d and the 30-day buy-box
shares carried over from our observations), fulfillment classifies every offer AMZ / FBA / FBM with delivery
days, seller_ratings lists the sellers' feedback records.

no_sellers=true means Amazon lists no offer for the product right now - an answer, not a failure: we confirm it
through a second, independent fetch before serving it. Billing: 0.5 credit when the answer carries at least one
offer (any condition); a no-offers answer, an ASIN Amazon does not have (404), a failed fetch (502) and a busy
marketplace (503) are never billed. Second-hand offers are counted either way; include_used lists them.
Since 2026-10-15 the answer carries buybox_condition (new | used | null = no featured offer) with
buybox_condition_source (offers_page) and buybox_condition_detail (the pinned offer's condition text or the used
storefront's name, e.g. Amazon Resale) — with zip= too.

## Query parameters

- `asin` string, nullable: Amazon ASIN (10 characters; a print book's ISBN-10). Provide asin or gtin.
- `gtin` string, nullable: A barcode instead of an ASIN (UPC / EAN / GTIN / ISBN-13), resolved exactly as /v1/product resolves gtin - the barcode on a listing we observe, a book's ISBN-10, the same product on another Amazon marketplace, then Amazon's own search (gtin_resolution says which). A barcode nothing resolves is a 404, never billed.
- `country` string: Amazon marketplace: us, uk, de, ca, au, fr, it, es, jp, mx, br (amazon-xx accepted). Amazon only.
- `marketplace` string, nullable: Alias for country (amazon-de or de).
- `include_used` boolean: Include used, refurbished, open-box and collectible offers in current_sellers.sellers. Default false lists the new-condition offers; current_sellers always carries used_offer_count, lowest_new and lowest_used either way. Not billed extra.
- `zip` string, nullable: (2026-10-14) A US 5-digit ZIP: the offers page as Amazon shows it to a shopper at that ZIP, with location (Amazon's confirmed 'Deliver to' answer) and deliverable (whether the item is offered to that ZIP right now - Amazon Fresh and Whole Foods items deliver only to some ZIPs). Page 1 of the offers only; a one-off session, nothing stored. country=us only. 1 credit when the answer carries an offer; a ZIP Amazon rejects is a 422, never billed.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/logimu/apis/logimu-api.md) · [All operations](https://skmtc.dev/logimu/apis/logimu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/logimu/apis/logimu-api/revisions/3d3f90ad2335?raw)