---
title: "Bestsellers"
method: GET
path: "/v1/bestsellers"
---

# Bestsellers

`GET /v1/bestsellers`

## 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/bestsellers`
- Auth: none declared

LIVE Amazon Best Sellers list for one category — up to 100 products in Amazon's rank order
(rank, ASIN, title, link, image, rating, ratings_total, price), the category's full breadcrumb
name and path (current_category), and its direct subcategories with their URLs, so a caller can
walk the tree. A root URL (or country alone) returns the marketplace's top-level categories
instead (page_type "root").

Fetched from Amazon at request time — expect ~15-35 s for the top 100, ~15 s for a root list (set
client timeouts to 180 s+). Amazon refreshes these lists hourly, so an answer may come from our
cache: up to 30 min old for a category, 24 h for the root list (`cached`, `cache_age_seconds`,
`observed_at` = when the list was fetched from Amazon).

Billing: 1 credit per page of 50 products returned (the full top 100 = 2), cached or fresh — it
is the same list. The root list is free. A category Amazon does not have (404), a blocked fetch
(502) and an empty list are never billed; a partial answer (page 2 failed) bills the page returned.

Honest limits: names are in the page's language (German pages are local; fr / it / es / jp / mx /
br are requested in English); ranks are Amazon's at fetch time; price is null when the card shows
none; node_id is null where Amazon's URL carries only a slug (top-level departments).

## Query parameters

- `url` string, nullable: Any Amazon Best Sellers URL: a category (/gp/bestsellers/kitchen/289814, /Best-Sellers-.../zgbs/..., with or without the /ref=... tail, query string or /-/en/ prefix) or a marketplace's root (/gp/bestsellers/). The marketplace comes from the host (all 11 Amazon marketplaces).
- `country` string, nullable: Optional. Alone (no url): that marketplace's root list of top-level categories. With url: must match the URL's marketplace. us, uk, de, ca, au, fr, it, es, jp, mx, br (amazon-xx accepted).
- `pages` integer: 1 = ranks 1-50, 2 = ranks 1-100 (default). Page 2 is fetched only when page 1 is full.

## 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)