---
title: "Product Keywords Route"
method: GET
path: "/v1/product/keywords"
---

# Product Keywords Route

`GET /v1/product/keywords`

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

Reverse ASIN: every keyword in the observed set whose latest page 1 shows the product - organically (with its rank) or
in a sponsored unit seen in the page HTML - with the keyword's result count and badges, dated. Organic first, best rank
first. With asins= (up to 10) it compares the product with its competitors: every keyword where any of them appears,
each one's rank, how many share the page and the gaps. 1 credit per page of 25 keywords returned, per ASIN; a product
not seen on any observed page is a 404, free.

## Query parameters

- `asin` string, nullable: 10-character Amazon ASIN (or use asins).
- `asins` string, nullable: Up to 10 ASINs, comma-separated: the product first, then the competitors to compare it with. Each row then carries every competitor's rank, asins_on_page and gap.
- `country` string: Amazon US only: the map covers amazon.com search.
- `placement` string: all (default), organic or sponsored.
- `gaps` boolean: With asins: only the keywords where a competitor is on page 1 organically and the first product is not.
- `limit` integer: Keywords per page (default 50); billed 1 credit per started 25 returned, per ASIN.
- `offset` integer: Skip this many keywords (paging).
- `history` boolean: Also return each keyword's rank_history: the first product's organic rank in every stored observation of that keyword. +0.5 credit once when any returned keyword has more than one observation.
- `history_points` integer: history=true: at most N observations per keyword, the newest kept.

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