SPECIFICATION V1.2 PRODUCT-MAPPER ENGINE

Overview & Architecture

ProductMapper is a high-performance barcode normalization and Amazon ASIN catalog matching platform. It transforms raw product identifiers (UPC, EAN, GTIN, ASIN, or Title) into structured Amazon catalog listings.

Resolution Pipeline

Every lookup is normalized (GS1 checksum validation) before resolving against Amazon's catalog. A lookup that can't be served instantly is queued as a background job rather than timing out your request - see Job Status & Polling for what that looks like from the API.

Core Features

• GS1 Checksum Validation: Modulo 10 verification flags invalid UPC/EAN/GTIN checksums on every normalized identifier.
• Multi-Region Marketplace Support: Resolves against North American, European, and Far East Amazon marketplaces (US, Canada, UK, Germany, France, Japan, Australia, and more).
• Batch Queue Processing: Background workers process up to 500 items concurrently without timing out HTTP requests.
• RFC 4180 CSV Exporter: One-click bulk export with sanitized quoting and formatted pricing.
• Lookup History: Every resolved lookup is recorded to your account and searchable/deletable via the history API.

Sample Response Payload

JSON /api/map

{
  "identifierType": "UPC",
  "identifierValue": "079361039905",
  "marketplace": "amazon",
  "marketplaceId": "B01NAL48FU",
  "listingDetails": {
    "asin": "B01NAL48FU",
    "title": "Nike Air Zoom Pegasus 36 Men's Running Shoes",
    "brand": "Nike",
    "price": 119.95,
    "formattedPrice": "$119.95",
    "offerCount": 6,
    "salesRank": 1420,
    "imageUrl": "https://m.media-amazon.com/images/I/71xyz.jpg"
  }
}

See Single Barcode Lookup for the full field reference, Job Status & Polling for what happens when resolution takes longer than 8 seconds, and Batch Queue & Jobs for bulk lookups.

Machine-Readable Schema

The same 7 REST endpoints documented across this site, as an OpenAPI 3.1 document or a ready-to-import Postman collection - generated from one shared definition, so the two never drift out of sync with each other. Neither includes MCP (AI agent) access, which uses a different transport not representable in either format.

OpenAPI 3.1

https://product-mapper.com/openapi.json

Download openapi.json

Postman Collection v2.1

https://product-mapper.com/postman.json

Download postman.json

Importing into Postman

Postman → Import → paste the URL above (or the downloaded file) → it drops in a baseUrl and apiKey collection variable to fill in, then every request is ready to run.

Client SDKs

Prefer a typed client over raw REST calls? Official Node.js/TypeScript and Python libraries wrap every endpoint documented here, with automatic retries and polling - see SDKs for install commands and usage examples.