{
  "name": "Apiguru Amazon Data API",
  "description": "Real-time structured Amazon marketplace data: product details, reviews, search, best-sellers, deals, seller profiles, and live offers/stock across 23 country marketplaces. Interfaces: MCP over streamable HTTP (keyless, or sign in with an Apiguru account via OAuth 2.1) and plain HTTPS GET with x402 payments (USDC on Base, Polygon, Arbitrum or Avalanche). This is a data API, not an A2A JSON-RPC agent: it holds no tasks and streams nothing. Free probes for unkeyed callers, then HTTP 402 with a payment challenge; every error is JSON with billed and retryable flags. Discovery: https://agent.apiguru.app/.well-known/x402 lists every endpoint with price and schema.",
  "version": "1.1.55",
  "documentationUrl": "https://github.com/apiguru-app/agent-kit#readme",
  "provider": {
    "organization": "Apiguru",
    "url": "https://apiguru.app"
  },
  "supportedInterfaces": [
    {
      "url": "https://mcp.apiguru.app/mcp",
      "protocolBinding": "https://modelcontextprotocol.io/specification/2025-06-18/basic/transports",
      "protocolVersion": "2025-06-18"
    },
    {
      "url": "https://mcp.apiguru.app/account",
      "protocolBinding": "https://modelcontextprotocol.io/specification/2025-06-18/basic/transports",
      "protocolVersion": "2025-06-18"
    },
    {
      "url": "https://agent.apiguru.app/agent/v1",
      "protocolBinding": "https://github.com/coinbase/x402",
      "protocolVersion": "2"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "apiKey": {
      "apiKeySecurityScheme": {
        "location": "header",
        "name": "X-API-KEY",
        "description": "An Apiguru dashboard API key; calls bill that account. Accepted on every interface. Get one at https://dash.apiguru.app/register."
      }
    },
    "oauth": {
      "oauth2SecurityScheme": {
        "description": "Sign in with an Apiguru account on https://mcp.apiguru.app/account (OAuth 2.1, PKCE, dynamic client registration). For clients that cannot send headers: claude.ai, Claude Desktop and ChatGPT connectors.",
        "oauth2MetadataUrl": "https://mcp.apiguru.app/.well-known/oauth-authorization-server",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://mcp.apiguru.app/authorize",
            "tokenUrl": "https://mcp.apiguru.app/token",
            "refreshUrl": "https://mcp.apiguru.app/token",
            "scopes": {
              "apiguru": "Call the API as the signed-in Apiguru account"
            },
            "pkceRequired": true
          }
        }
      }
    },
    "x402": {
      "httpAuthSecurityScheme": {
        "scheme": "x402",
        "description": "No account: call the HTTPS interface with no credentials; after the free probes it answers 402 with a PAYMENT-REQUIRED challenge. Settle it in USDC on Base, Polygon, Arbitrum or Avalanche and retry with PAYMENT-SIGNATURE. Verify, serve, settle: nothing is charged for an answer the upstream could not give."
      }
    }
  },
  "securityRequirements": [
    {
      "schemes": {}
    },
    {
      "schemes": {
        "apiKey": {
          "list": []
        }
      }
    },
    {
      "schemes": {
        "x402": {
          "list": []
        }
      }
    },
    {
      "schemes": {
        "oauth": {
          "list": [
            "apiguru"
          ]
        }
      }
    }
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "product_details",
      "name": "Full product detail for a single ASIN",
      "description": "Real-time Amazon product data for any ASIN: title, current price, star rating, review count, images, feature bullets, variations and category. Covers 23 country marketplaces including US, UK, DE, JP, IN and BR. Returns live data fetched at request time, not a cache. Price: $0.003 per call. HTTP: GET https://agent.apiguru.app/agent/v1/v2/product-details. MCP tool: product_details.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "product",
        "details"
      ],
      "examples": [
        "What does ASIN B09DJLW458 cost on amazon.com right now, and what is its rating?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "product_reviews",
      "name": "Customer reviews for a single ASIN",
      "description": "Amazon customer reviews for any ASIN: overall star rating, total rating count, the 'customers say' AI summary, and individual review text with per-review ratings. Useful for sentiment analysis, product research and competitive monitoring across 23 marketplaces. Price: $0.003 per call. HTTP: GET https://agent.apiguru.app/agent/v1/v2/product-reviews. MCP tool: product_reviews.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "product",
        "reviews"
      ],
      "examples": [
        "Summarise the most recent customer reviews for ASIN B09DJLW458 on amazon.de."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "search",
      "name": "Search Amazon products by keyword",
      "description": "Search Amazon by keyword and get back structured product results: ASIN, title, price, rating and image for each hit. Supports pagination, six sort orders, and filters for category, price range, brand, seller and product condition. Works across 23 country marketplaces. Price: $0.003 per call. HTTP: GET https://agent.apiguru.app/agent/v1/search. MCP tool: search.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "search"
      ],
      "examples": [
        "Find the top-rated USB-C hubs under $40 on amazon.com."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "product_details_batch",
      "name": "Product detail for up to 20 ASINs in one call",
      "description": "Fetch Amazon product data for up to 20 ASINs in a single request: title, price, rating, review count and images for each. Deduplicates the input list and fetches concurrently, so bulk catalogue enrichment costs one round trip instead of twenty. Covers 23 country marketplaces. Price: $0.0024 per item, up to 20 per call. HTTP: GET https://agent.apiguru.app/agent/v1/product. MCP tool: product_details_batch.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "product",
        "details"
      ],
      "examples": [
        "Compare current prices for these 15 ASINs on amazon.co.uk."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "offers_stock",
      "name": "Live offers and inventory for up to 10 ASINs",
      "description": "Live Amazon offer and inventory data for up to 10 ASINs: every active offer with seller, price, shipping and condition, which one holds the buy box, and optionally the real purchasable stock quantity. Built for repricing, buy-box monitoring and stock-out alerting across 23 marketplaces. Price: $0.0045 per item, up to 10 per call. HTTP: GET https://agent.apiguru.app/agent/v1/stock. MCP tool: offers_stock.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "offers",
        "stock"
      ],
      "examples": [
        "Who holds the buy box for ASIN B09DJLW458 in the US, and is it in stock?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "best_sellers",
      "name": "Best-seller rankings for a category",
      "description": "Current Amazon best-seller rankings for any category or subcategory, with rank, ASIN, title, price and rating for each entry. Paginated and available across 23 country marketplaces. Useful for trend detection, category research and product sourcing. Price: $0.003 per call. HTTP: GET https://agent.apiguru.app/agent/v1/v2/best-sellers. MCP tool: best_sellers.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "best",
        "sellers"
      ],
      "examples": [
        "List today's best sellers in Amazon US Electronics."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "deals",
      "name": "Current Amazon deals with filters",
      "description": "Live Amazon deals feed with current discounts: ASIN, title, deal price, original price, discount percentage, deal badge and end time. Filter by department, brand id, 4-star rating cut-off, min/max price, minimum discount or Prime program; each answer lists the category and brand ids it accepts and where the next page starts. 23 marketplaces. Built for deal aggregation and price-drop alerting. Price: $0.003 per call. HTTP: GET https://agent.apiguru.app/agent/v1/v2/deals. MCP tool: deals.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "deals"
      ],
      "examples": [
        "Show current Amazon US deals on kitchen appliances with at least 30% off."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "seller_profile_batch",
      "name": "Seller profiles for up to 10 seller IDs",
      "description": "Amazon seller profile data for up to 10 seller IDs in one call: business name, legal address, star rating, feedback counts over 30/90/365 days, and marketplace presence. Built for supplier vetting, competitor research and marketplace due diligence across 20 countries. Price: $0.0036 per item, up to 10 per call. HTTP: GET https://agent.apiguru.app/agent/v1/seller-profile. MCP tool: seller_profile_batch.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "seller",
        "profile"
      ],
      "examples": [
        "Look up the seller ratings for these Amazon seller IDs."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "seller_products",
      "name": "Products listed by a seller",
      "description": "List every product in an Amazon seller's storefront: ASIN, title, price, rating and image, paginated. Built for competitor catalogue monitoring, supplier assortment analysis and brand-protection sweeps across 23 marketplaces. Price: $0.003 per call. HTTP: GET https://agent.apiguru.app/agent/v1/v2/seller-products. MCP tool: seller_products.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "seller",
        "products"
      ],
      "examples": [
        "What does Amazon.com's own storefront (seller ATVPDKIKX0DER) list right now?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "seller_reviews",
      "name": "Feedback reviews for a seller",
      "description": "Amazon seller feedback reviews with rating, date and review text, paginated and filterable to a star-rating window. Built for supplier vetting, reputation monitoring and detecting seller quality drift across 23 marketplaces. Price: $0.003 per call. HTTP: GET https://agent.apiguru.app/agent/v1/v2/seller-reviews. MCP tool: seller_reviews.",
      "tags": [
        "amazon",
        "ecommerce",
        "marketplace-data",
        "real-time",
        "seller",
        "reviews"
      ],
      "examples": [
        "What are buyers saying about seller ATVPDKIKX0DER on amazon.com?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}