---
title: "Keyword Rankings Route"
method: GET
path: "/v1/keywords/rankings"
---

# Keyword Rankings Route

`GET /v1/keywords/rankings`

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

Page 1 of Amazon US search for a keyword, as we last observed it: the organic order with product facts and each
product's latest observed buy box, the sponsored units present in the page HTML, the keyword's badges (Overall Pick),
Amazon's result count, who holds the page (page_summary) and what changed since the previous observation, dated.
Observed positions, a weekly sample, never volume figures. 1 credit; a keyword not in the set or not observed yet is
a 404, free.

## Query parameters

- `keyword` string, required: A search term, e.g. 'micro sd card 128gb high endurance' (case-insensitive).
- `country` string: Amazon US only: the map covers amazon.com search.
- `history` boolean: Also return history: every stored observation of the keyword (about one a week) and the organic-rank series of the products on the latest page. +0.5 credit when more than the latest observation came back.
- `history_points` integer: history=true: at most N observations, the newest kept (default 26).

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