ASINtoJSON API

Retrieve normalized public Amazon product metadata from an ASIN or Amazon product URL. This single-product API is intended for developers, AI agents, scripts, and server-to-server clients.

Each POST /api/v1/lookup request accepts one product input, not an array.

Endpoint

POST https://asintojson.com/api/v1/lookup

Send Content-Type: application/json. application/json; charset=utf-8 is also accepted. POST is the supported lookup operation. Unsupported application methods such as GET and PUT return HTTP 405. OPTIONS is handled automatically by the framework and currently returns HTTP 204 with Allow: OPTIONS, POST; it is not a lookup operation.

Maximum request body: 16 KiB / 16,384 bytes. A larger body receives HTTP 413 PAYLOAD_TOO_LARGE before JSON parsing, with a server-generated request ID.

There is no wildcard CORS support for arbitrary third-party browser frontends. Call from a server, AI agent, script, or curl.

Authentication

No API key is currently required. Limits apply to a server-derived client identity based on trusted ingress information.

Example request

curl -X POST https://asintojson.com/api/v1/lookup \
  -H "Content-Type: application/json" \
  -d '{"input":"B01LR5RG08","marketplace":"amazon.com"}'
FieldRequiredContract
inputYesString, at most 4,096 UTF-16 code units; a valid ASIN or supported Amazon product URL.
marketplaceNoString, at most 64 UTF-16 code units; selects the marketplace for a bare ASIN. Omitted or empty defaults to amazon.com.
request_idNo8–128 ASCII letters, digits, underscores, or hyphens. Used for correlation, not idempotency. Generated by the server when omitted.

Unknown request fields are rejected. The request cannot choose its client identity or change protection settings.

ASCII characters each use one UTF-16 code unit; supplementary Unicode characters may use two. These string limits are separate from the full request body limit of 16,384 bytes. Standard JSON Schema maxLength does not express the runtime code-unit limit; clients must also enforce the documented limit.

Supported input

A bare ASIN is ten alphanumeric characters; surrounding whitespace is trimmed and letters are normalized to uppercase. Product URLs support /dp/{ASIN}, /gp/product/{ASIN}, and /gp/aw/d/{ASIN}. Short links and search URLs are not supported.

A product URL keeps its own recognized marketplace. For example, https://www.amazon.co.uk/dp/B0C27P6VC9 selects amazon.co.uk. An explicitly supplied non-empty marketplace must still be supported.

Supported marketplaces

18 canonical marketplace hostnames: amazon.com, amazon.ca, amazon.com.mx, amazon.com.br, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se, amazon.pl, amazon.co.jp, amazon.in, amazon.com.au, amazon.sg, amazon.ae, amazon.sa.

Marketplace matching is case-insensitive and accepts a www. prefix or trailing dot. Use the canonical hostname in new clients.

Example response

This HTTP 200 example is illustrative. Its values are not claims about the current live product.

{
  "ok": true,
  "data": {
    "asin": "B01LR5RG08",
    "marketplace": "amazon.com",
    "source_url": "https://www.amazon.com/dp/B01LR5RG08",
    "currency": "USD",
    "canonical_url": "https://www.amazon.com/dp/B01LR5RG08",
    "title": "Illustrative product title",
    "main_image": null,
    "images": [],
    "rating": null,
    "review_count": null,
    "category": [],
    "brand": null,
    "bsr": null,
    "product_information": [
      {
        "title": "Product details",
        "attributes": {
          "ASIN": "B01LR5RG08"
        }
      }
    ]
  },
  "meta": {
    "request_id": "example-request-123",
    "cached": false,
    "fetched_at": "2026-10-14T12:00:00.000Z",
    "quota": {
      "limit": 20,
      "remaining": 19,
      "reset": "2026-10-15T00:00:00.000Z"
    }
  },
  "warnings": [
    "MAIN_IMAGE_MISSING",
    "RATING_MISSING",
    "REVIEW_COUNT_MISSING",
    "CATEGORY_MISSING"
  ]
}

All 14 product fields shown above are required. Only main_image, rating, review_count, brand, and bsr may be null. images and category are string arrays; all arrays may be empty. Each product_information section has a required string title and attributes, a map of string values.

meta.quota is required: limit is a number, remaining is a number or null, and reset is the next UTC day boundary in ISO form, such as 2026-10-15T00:00:00.000Z. fetched_at records original acquisition time, including when a result is served from cache.

warnings is a required array of at most four unique codes: MAIN_IMAGE_MISSING, RATING_MISSING, REVIEW_COUNT_MISSING, CATEGORY_MISSING. It may be empty.

Responses contain only the documented fields. Product metadata excludes price, stock, seller or Buy Box information, delivery estimates, review text, and private account data. See data methodology for source and freshness limitations.

Rate limits and quota

Current production policy: 5 lookup requests per minute per server-derived client identity and 20 fresh lookups per UTC day per identity. Cache hits count against the minute request limit but do not consume fresh/day quota. Negative cache results do not consume fresh/day quota. Fresh failures do not consume finalized daily quota. Concurrent lookups for the same product may share acquisition; followers do not consume another fresh quota. Only a fresh successful acquisition consumes fresh quota. Daily quota resets at the next UTC day boundary. remaining=null means quota status is temporarily unavailable, not unlimited usage. Protective fallback limits may be stricter during a storage outage.

The minute limit applies after lookup input validation, including cache hits. Invalid request bodies and inputs rejected before lookup execution do not start a lookup.

Errors

Error JSON has ok: false, error with code, message, retryable, and meta.request_id. A positive retry_after_seconds may be present only for retryable errors. Public JSON responses use Cache-Control: no-store.

Public codeHTTPRetryableMeaning
INVALID_INPUT400falseMissing, malformed, invalid, or unsupported request input.
UNSUPPORTED_MARKETPLACE400falseThe requested Amazon marketplace is not supported.
PRODUCT_NOT_FOUND404falseNo active product was found in the selected marketplace.
PRODUCT_UNAVAILABLE409falseThe product is currently unavailable.
PRODUCT_RETIRED410falseThe product is no longer available.
PAYLOAD_TOO_LARGE413falseThe request body exceeds 16,384 bytes.
INVALID_INPUT415falseContent-Type must be application/json; charset=utf-8 is also accepted.
RATE_LIMITED429trueThe per-identity minute request limit has been reached.
DAILY_QUOTA_EXCEEDED429trueThe daily fresh lookup quota has been reached; wait until UTC reset.
INTERNAL_ERROR500falseThe lookup could not be completed safely.
UPSTREAM_UNAVAILABLE502falseAmazon returned a response that could not be processed.
SERVICE_BUSY503trueThe lookup service is temporarily busy.
UPSTREAM_UNAVAILABLE503trueAmazon is temporarily unavailable for lookup.
UPSTREAM_UNAVAILABLE504trueAmazon took too long to respond.

Retry behavior

Do not automatically retry when retryable=false. When retryable=true, a caller may wait and retry. Prefer the HTTP Retry-After header when provided; otherwise use retry_after_seconds when present. If neither is present, use bounded backoff. Do not retry every 5xx response: HTTP 500 and 502 are non-retryable.

OpenAPI

Download the machine-readable OpenAPI 3.1 specification to configure an agent or generate a client for /api/v1/lookup.

ASINtoJSON is independent and is not affiliated with Amazon.