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

# Keywords Route

`GET /v1/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/keywords`
- Auth: none declared

Amazon's own autocomplete suggestion lists for a seed (2026-10-07): up to 6 lists - one per crawled prefix / department -
each term with its position 1-10 within that list, when it was first and last observed, since when it has been in the list
and the marketplaces it was observed in; plus related observed vocabulary. Observed suggestion ranking, not volume figures,
not a product-ranking map. 1 credit; unknown seed 404, free.

## Query parameters

- `seed` string, required: A seed term or prefix, e.g. 'electric toothbrush' - at least 3 characters.
- `country` string: Amazon marketplace: us, uk, de, ca, au, fr, it, es, jp, mx, br (Walmart has no autocomplete corpus).
- `history` boolean: Also return history: every observation of each returned list since the harvest began (a term entering, leaving or moving position). +0.5 credit when at least one closed observation exists.
- `history_points` integer: history=true: at most N observation rows across the lists (oldest first).
- `related_limit` integer: Related observed vocabulary starting with the seed (default 25).

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