# ProductMapper

> ProductMapper is a REST API that resolves product identifiers (UPC, EAN, GTIN, ASIN, or free-text
> title) to live Amazon catalog listings - ASIN, price, sales rank, images, and product attributes.
> Supports single-lookup and batch (up to 500 items) endpoints, with results cached and available
> as searchable lookup history. Free plan: 500 mapping credits/week, no card required.

## API Reference

- [API Overview & Architecture](https://product-mapper.com/docs): Resolution pipeline, core features, and a sample response payload.
- [Single Barcode Lookup](https://product-mapper.com/docs/api-single): POST /api/map - resolve one identifier synchronously, with full request/response field reference.
- [Batch Queue & Jobs](https://product-mapper.com/docs/api-batch): POST /api/map/batch - submit up to 500 identifiers at once, track progress, export as CSV.
- [Job Status & Polling](https://product-mapper.com/docs/api-status): GET /api/jobs/{id} - retrieve results for a lookup that took longer than 8 seconds.
- [Lookup History](https://product-mapper.com/docs/api-history): GET/DELETE /api/history - search, page, and delete past lookups.

## MCP (Model Context Protocol)

ProductMapper runs a native MCP server at /api/mcp (SSE transport, JSON-RPC 2.0) exposing four tools - lookup, batch_lookup, batch_lookup_status, and history_search - authenticated with a personal API key generated at /dashboard/api-keys. An AI coding agent (Claude Code, Claude Desktop, Cursor, Windsurf) can call these directly; see the API Keys dashboard page for ready-to-copy client config.

## Pricing & Access

- [Pricing](https://product-mapper.com/pricing): Plan tiers (Free, Pro, High, Custom), weekly credit allowances, and one-time credit packs.
- [Free account signup](https://product-mapper.com/sign-up): 500 mapping credits/week, no card required.
- [Contact](https://product-mapper.com/contact): Questions about the API, billing, or a custom plan.