---
title: "Search"
method: GET
path: "/v1/search"
---

# Search

`GET /v1/search`

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

Filter our tracked-product warehouse - 11 Amazon marketplaces (US, UK, DE, CA, AU, FR, IT, ES, JP, MX, BR) plus Walmart US.

Provide **one anchor** — any of `q` (keyword), `brand`, or `category` (2026-08-10) is
enough on its own. `category` browses a whole department or sub-category with no keyword
(`?category=Home & Kitchen`); its name is matched in full and case-insensitively against
the product's category chain, a name we don't carry returns 422 with the nearest matches,
and a category-only browse returns the category's top products by in-category best-seller
rank before applying your filters and `sort`. `seller` only refines and cannot start a
search. Every filter (price/rating/reviews/bsr/fba/seller_count) narrows the anchored set;
`total_matched` is the recall pool so you can see how much your filters and `limit` cut.

## Query parameters

- `marketplace` 'amazon-us' | 'amazon-uk' | 'amazon-de' | 'amazon-ca' | 'amazon-au' | 'amazon-fr' | 'amazon-it' | 'amazon-es' | 'amazon-jp' | 'amazon-mx' | 'amazon-br' | 'walmart'
- `q` string, nullable
- `brand` string, nullable
- `seller` string, nullable
- `category` string, nullable
- `price_min` number, nullable
- `price_max` number, nullable
- `rating_min` number, nullable
- `rating_max` number, nullable
- `reviews_min` integer, nullable
- `bsr_min` integer, nullable
- `bsr_max` integer, nullable
- `fba` boolean, nullable
- `fbm` boolean, nullable
- `fulfillment` string, nullable
- `seller_count_min` integer, nullable
- `seller_count_max` integer, nullable
- `sort` 'rating' | 'reviews' | 'bsr' | 'price' | 'sales_estimate' | 'seller_count'
- `max_per_category` integer, nullable
- `limit` integer

## Headers

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

## Response `200`

Successful Response

- SearchResponse
  - `source` string
  - `marketplace` string, required
  - `limit` integer, required
  - `returned` integer, required
  - `total_matched` integer, nullable
  - `credits_charged` number, required
  - `credits_remaining` number, nullable
  - `dropped_terms` string[], nullable
  - `note` string, nullable
  - `seller_ratings` SellerRating[], nullable
    - `seller` string, nullable
    - `seller_id` string, nullable
    - `seller_positive_pct` number, nullable
    - `seller_feedback_count` integer, nullable
    - `seller_rating` number, nullable
    - `observed_at` string, nullable
  - `products` ProductRow[], required
    - `asin` string, required
    - `product_id` string, nullable
    - `product_url` string, nullable
    - `marketplace` string, required
    - `title` string, nullable
    - `brand` string, nullable
    - `category` string, nullable
    - `price` number, nullable
    - `currency` string, nullable
    - `bsr` integer, nullable
    - `rating` number, nullable
    - `reviews_count` integer, nullable
    - `seller_count` integer, nullable
    - `buybox_seller` string, nullable
    - `buybox_seller_id` string, nullable
    - `fba` boolean, nullable
    - `fulfillment` string, nullable
    - `image` string, nullable
    - `review_count` integer, nullable
    - `image_url` string, nullable
    - `is_fba` boolean, nullable
    - `in_stock` boolean, nullable
    - `bought_past_month` integer, nullable
    - `sales_estimate` integer, nullable
    - `as_of` string, nullable

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