# Keepa API Documentation

> Everything you need to integrate Keepa data into your application: how to get access, make your first request, and where each endpoint and response object is documented.

Every page below is Markdown; the same page as HTML is at the same address ending in .html (https://env.7xmtools.com/api-docs/ for the overview). All requests go to https://api.keepa.com/ with your API key as the `key` parameter.

## Start here

- [Quick reference](https://env.7xmtools.com/api-docs/quick-reference.md): every endpoint with its method, path, token cost and parameters, in one file

## Getting Started

- [Overview](https://env.7xmtools.com/api-docs/index.md): Keepa API documentation: price history, product data, deals, sellers and tracking for Amazon marketplaces.
- [Making Requests](https://env.7xmtools.com/api-docs/request-basics.md): How to call the Keepa API: base URL, API access key, HTTPS with gzip or zstd and keep-alive, the token-bucket response envelope, and HTTP status codes.
- [Plans & Tokens](https://env.7xmtools.com/api-docs/plans-tokens.md): How Keepa API plans work: the token bucket rate-limiting model, subscription management, payment, and the token costs of each request type.
- [MCP Server](https://env.7xmtools.com/api-docs/mcp.md): Connect AI assistants like Claude and ChatGPT to Amazon price history, deals, sellers and product research through Keepa's hosted Model Context Protocol (MCP) server.
- [API Changelog](https://env.7xmtools.com/api-docs/changelog.md): A record of additions, changes and deprecations to the Keepa API, listed newest first.
- [Settings](https://env.7xmtools.com/api-docs/settings.md): Store your Keepa API access key locally to run the interactive code examples directly from the documentation.

## Endpoints

- [Product Request](https://env.7xmtools.com/api-docs/product.md): Retrieve Keepa product objects by ASIN, UPC, EAN, GTIN or ISBN-13 — including price history, statistics, marketplace offers, Buy Box, stock and variation data.
- [Product Search](https://env.7xmtools.com/api-docs/product-search.md): Search for Amazon products by keyword via the Keepa API /search endpoint — up to 20 results per search term, in Amazon search order.
- [Product Finder](https://env.7xmtools.com/api-docs/product-finder.md): Keepa Product Finder request (/query): search the Keepa product database by nearly any product field, receive ASIN lists and aggregated Search Insights.
- [Browsing Deals](https://env.7xmtools.com/api-docs/deals.md): The Keepa /deal endpoint: browse recently changed products matching your criteria using a JSON query — all parameters, paging, token cost, and request/response examples.
- [Best Sellers](https://env.7xmtools.com/api-docs/best-sellers.md): Retrieve a ranked ASIN list of the most popular products of an Amazon category or product group via the Keepa API /bestsellers endpoint.
- [Category Lookup](https://env.7xmtools.com/api-docs/category-lookup.md): Retrieve Keepa category objects and optionally their parent tree using an Amazon category node ID.
- [Category Search](https://env.7xmtools.com/api-docs/category-search.md): Search for Amazon category names by keyword and retrieve up to 50 matching category objects via the Keepa API /search endpoint.
- [Seller Information](https://env.7xmtools.com/api-docs/seller.md): Retrieve seller objects by seller ID via the Keepa API /seller endpoint, optionally including the seller's storefront ASIN list.
- [Seller Finder](https://env.7xmtools.com/api-docs/seller-finder.md): Keepa Seller Finder request (/sellerquery): search the Keepa merchant database by name, business details, ratings, fulfilment and catalogue profile, and receive seller ID lists.
- [Most Rated Sellers](https://env.7xmtools.com/api-docs/most-rated-sellers.md): Retrieve a daily updated, ordered list of the most rated Amazon marketplace seller IDs via the Keepa API /topseller endpoint.
- [Lightning Deals](https://env.7xmtools.com/api-docs/lightning-deals.md): Keepa API Lightning Deals request: retrieve a single Amazon Lightning Deal by ASIN or the complete list of deals from the past four days, optionally filtered by state.
- [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.md): Retrieve a rendered PNG price history chart for any Amazon product via the Keepa Graph Image API, with configurable data series, size, range and colors.
- [Tracking API](https://env.7xmtools.com/api-docs/tracking.md): Keepa Tracking API: add, retrieve and remove product trackings, manage named tracking lists, and receive price alerts via webhook push or API pull.

## Response Objects

- [Product Object](https://env.7xmtools.com/api-docs/product-object.md): Complete reference for the Keepa API Product Object: every field, the csv price history array with all history types, price history decoding and Keepa Time conversion.
- [Statistics Object](https://env.7xmtools.com/api-docs/statistics-object.md): Reference for the Keepa API Statistics object: current, average, minimum and maximum prices, out-of-stock percentages, sales rank drops and Buy Box statistics.
- [Marketplace Offer Object](https://env.7xmtools.com/api-docs/offer-object.md): Reference for the Keepa API marketplace offer object: offer identity, seller, condition, Prime/FBA flags, coupon data and the price, shipping, stock and Prime exclusive price histories.
- [Category Object](https://env.7xmtools.com/api-docs/category-object.md): Reference for the Keepa API Category Object: category tree navigation fields plus aggregated category statistics such as average Buy Box price, offer counts and top brands.
- [Deal Object](https://env.7xmtools.com/api-docs/deal-object.md): Reference for the Keepa API deal object: product summary, current prices and ranks, average/delta/deltaPercent arrays per date range, and deal metadata such as lightningEnd and warehouse condition.
- [Best Sellers Object](https://env.7xmtools.com/api-docs/best-sellers-object.md): Structure of the Keepa Best Sellers Object: a ranked list of best-selling ASINs for a specific Amazon category.
- [Seller Object](https://env.7xmtools.com/api-docs/seller-object.md): Structure of the Keepa Seller Object: name, business data, rating history, storefront ASINs, category/brand statistics and Buy Box ownership of an Amazon marketplace seller.
- [Lightning Deal Object](https://env.7xmtools.com/api-docs/lightning-deal-object.md): Structure of the Keepa Lightning Deal Object: deal price, state, claim progress, timing and variation attributes of an Amazon Lightning Deal.
- [Search Insights Object](https://env.7xmtools.com/api-docs/search-insights-object.md): Structure of the Keepa Search Insights Object: aggregated KPIs (average Buy Box prices, seller and brand distribution, fulfilment mix, review statistics) over all products matching a Product Finder query.
- [Tracking Object](https://env.7xmtools.com/api-docs/tracking-object.md): Structure of the Keepa Tracking Object: a price watch with threshold values, notify-if criteria, notification channels and notification history.
- [Tracking Creation Object](https://env.7xmtools.com/api-docs/tracking-creation-object.md): Structure of the Keepa Tracking Creation Object used to create a price watch via the Tracking API: TTL, desired prices, notify-if criteria and notification channels.
- [Notification Object](https://env.7xmtools.com/api-docs/notification-object.md): Structure of the Keepa Notification Object: a price alert with trigger cause, price type, current prices and delivery channels. Notifications are deleted after 24 hours.

## Optional

- [All pages in one file](https://env.7xmtools.com/api-docs/llms-full.txt): every page above, in this order