For the complete documentation index, see llms.txt. This page is also available as Markdown.

Search ASINs

Find your enrolled ASINs by text, marketplace, product type, or revenue tier.

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, Keyword Bank, 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 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.

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

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.

Last updated