Search Amazon by keyword or browse bestsellers by category slug

[
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "9MkM5Ra48KFcSv9HDQ8sb3C3r5HjouEwGQ6sp1cx1vde",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "5000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xC751344Ee09B5159160173F77D4a1169bCd386A1",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:143",
    "payTo": "0xC751344Ee09B5159160173F77D4a1169bCd386A1",
    "asset": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
    "amount": "5000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "query": "LG Ultragear OLED 34",
          "tld": "de"
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "mode": "query",
          "organic": [
            {
              "asin": "B0F59XT8QM",
              "currency": "EUR",
              "price_gross": 782.04,
              "title": "LG Ultragear ..."
            }
          ],
          "page": 1,
          "tld": "de"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "properties": {
                "category_slug": {
                  "description": "Amazon bestsellers category slug, e.g. 'electronics' (.com), 'elektronik' (.de), 'electronique' (.fr). Invalid slugs return 'not_found' - retry with a correct slug.",
                  "type": "string"
                },
                "include_paid": {
                  "default": false,
                  "description": "Include sponsored ad results (default: dropped)",
                  "type": "boolean"
                },
                "include_suggested": {
                  "default": false,
                  "description": "Include 'people also searched for' suggestions (default: dropped)",
                  "type": "boolean"
                },
                "keyword": {
                  "description": "Alias of 'query'",
                  "type": "string"
                },
                "keywords": {
                  "description": "Alias of 'query'",
                  "type": "string"
                },
                "min_reviews": {
                  "description": "Drop hits with fewer than N reviews. Pair with sort_by='most_reviewed' for a trust-weighted result. Applied client-side to organic/paid/suggested.",
                  "maximum": 9007199254740991,
                  "minimum": 0,
                  "type": "integer"
                },
                "page": {
                  "default": 1,
                  "description": "Page number (1-20)",
                  "maximum": 20,
                  "minimum": 1,
                  "type": "integer"
                },
                "q": {
                  "description": "Alias of 'query'",
                  "type": "string"
                },
                "query": {
                  "description": "Free-text keyword query (mutually exclusive with category_slug)",
                  "type": "string"
                },
                "response_format": {
                  "default": "concise",
                  "description": "'concise' drops images/variants/deep seller metadata; 'detailed' keeps everything",
                  "enum": [
                    "concise",
                    "detailed"
                  ],
                  "type": "string"
                },
                "sort_by": {
                  "description": "Server-side sort, except 'most_reviewed' which re-ranks the current page client-side by review count desc (rating tiebreaker). Pair 'most_reviewed' with min_reviews to skip thinly-reviewed items.",
                  "enum": [
                    "most_recent",
                    "price_low_to_high",
                    "price_high_to_low",
                    "featured",
                    "average_review",
                    "bestsellers",
                    "most_reviewed"
                  ],
                  "type": "string"
                },
                "tld": {
                  "default": "com",
                  "description": "Amazon marketplace: com | co.uk | de | fr | es | it",
                  "enum": [
                    "com",
                    "co.uk",
                    "de",
                    "fr",
                    "es",
                    "it"
                  ],
                  "type": "string"
                }
              },
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://glim.sh/api/v1/amazon/search"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://glim.sh/api/v1/amazon/search");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://glim.sh/api/v1/amazon/search")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header