Catalog / Amazon Public Catalog

Amazon Public Catalog API

amazon.com

Live, anonymous, read-only access to Amazon.com public catalog pages. Discover departments and search suggestions, search ranked product listings, browse best-sellers, and retrieve product details by ASIN. Prices and availability are observations for the request's anonymous Amazon session and can change. Purchases, carts, checkout, accounts, reviews, and other writes are not exposed.

  • shopping
  • amazon
  • products
  • search
5 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Amazon Public Catalog API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Browse Amazon best sellers

Optional parameters 1

Optional Amazon best-seller section slug discovered from /v1/categories.

View call pricing
cURL · Bestsellers
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/d455da0f-a736-4799-a69a-62169a75298c/v1/bestsellers' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETBestsellers/v1/bestsellers

Browse Amazon best sellers

Input

categoryOptionalQuery · string | null

Optional Amazon best-seller section slug discovered from /v1/categories.

Example: electronics

Response

itemsobject[]
items[].url?string | null
items[].asinstring
items[].rank?integer | null
items[].badge?string | null
items[].price?object
items[].price.amountnumber
items[].price.currencystring
items[].price.source_textstring
items[].titlestring
items[].rating?number | null
items[].image_url?string | null
items[].rank_scope?string | null
items[].is_sponsored?boolean, default: false
items[].review_count?integer | null
categorystring | null
categoriesobject[]
categories[].idstring
categories[].urlstring
categories[].kindstring
categories[].labelstring
source_urlstring
returned_countinteger

Fields marked ? are optional.

GETCategories/v1/categories

Discover Amazon search departments

Input

No input parameters.

Response

source_urlstring
departmentsobject[]
departments[].idstring
departments[].urlstring
departments[].kindstring
departments[].labelstring
bestseller_categoriesobject[]
bestseller_categories[].idstring
bestseller_categories[].urlstring
bestseller_categories[].kindstring
bestseller_categories[].labelstring
GETProducts by asin/v1/products/{asin}

Retrieve one Amazon product

Input

asinRequiredPath · string

Amazon ASIN returned unchanged by search or best-seller results; ten ASCII letters or digits, case-insensitive.

Example: B08N5KWB9H

Response

urlstring
asinstring
brandstring | null
priceobject
price.amountnumber
price.currencystring
price.source_textstring
storestring | null
titlestring
imagesstring[]
ratingnumber | null
bulletsstring[]
attributesobject[]
attributes[].namestring
attributes[].valuestring
review_countinteger | null
availability_textstring | null
GETSuggestions/v1/suggestions

Resolve a partial search phrase

Input

prefixRequiredQuery · string

Partial phrase typed into Amazon's search box.

Example: wireless

Response

prefixstring
source_urlstring
suggestionsobject[]
suggestions[].type?string | null
suggestions[].valuestring
suggestions[].source?string | null

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.