> For the complete documentation index, see [llms.txt](https://docs.autopilotbrand.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autopilotbrand.com/autopilot-mcp/tools/search-asins.md).

# Search ASINs

`search_asins`

Searches the enrolled ASINs in your organization and returns a short list of matches — ASIN, marketplace, title, and Amazon product type — so you (and the assistant) can pick a product to look at in more detail. It's the usual first step when you don't already have an ASIN in hand.

## When it's used

Reach for this whenever you want to find products rather than read a specific one: browsing by keyword, focusing on your top revenue drivers, or narrowing to a single marketplace. The assistant typically follows up on your chosen result with [Get Product Listing](/autopilot-mcp/tools/get-asin-listing.md), [Keyword Bank](/autopilot-mcp/tools/list-asin-keywords.md), or the other per-ASIN tools.

## What you can ask

> *"Find my enrolled products with 'hydration' in the title on Amazon US."*

> *"List my top revenue-tier A ASINs in the UK."*

> *"Search my enrolled ASINs for the Acme brand."*

> *"List my SHOES ASINs on Amazon US."*

> *"How many enrolled ASINs do I have per product type?"*

## Parameters

| Parameter        | Required | Description                                                                                                                           |
| ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `query`          | No       | Case-insensitive substring matched against ASIN, listing title, or brand name. Omit to list without text filtering.                   |
| `marketplace_id` | No       | Restrict to one marketplace (see the [Tools page](/autopilot-mcp/tools.md#identifiers) for IDs).                                      |
| `value_rating`   | No       | Revenue tier: **A** = top revenue ASINs for the brand, **B** = middle, **C** = bottom.                                                |
| `product_type`   | No       | Restrict to one Amazon product type — case-insensitive exact name as it appears in the result rows (e.g. `SHOES`, `BOOT`, `APPAREL`). |
| `page`           | No       | 1-indexed page number for paging through large result sets.                                                                           |

## What you get back

A paged list of minimal rows — `asin`, `marketplace_id`, `title`, and `product_type` — designed so the assistant can pick targets and chain into the per-ASIN tools. When there are more results, a next-page marker lets the assistant load more on request.

{% hint style="info" %}
The **value rating** (A/B/C) is Autopilot's revenue tier for the ASIN within its brand — a quick way to focus on your highest-revenue products (A) or your long tail (C).
{% endhint %}

{% hint style="info" %}
The **product type** is Amazon's classification for the ASIN (`SHOES`, `APPAREL`, …). It can be empty for recently enrolled ASINs whose catalog data hasn't been imported yet — those ASINs are excluded when you filter by `product_type`. The result's total count also makes quick per-type tallies possible: ask the assistant how your catalog splits across product types and it can answer with one cheap search per type.
{% endhint %}