Developer documentation

Ship your first call in minutes.

Glade exposes the same canonical Amazon operations through REST, GraphQL, and MCP. Every successful operation uses one unit.

Quickstart

Create a reveal-once API key in the dashboard, then send it with the API-KEY header.

curl "https://api.glade.dev/api/amazon/product?asin=B0D1XD1ZV3&domain=US" \
  -H "API-KEY: glade_live_lookup_your_secret"

Authentication

REST and GraphQL accept API-KEY or Bearer authentication. MCP additionally accepts GLADE-API-KEY, the Canopy compatibility alias, and X-API-KEY. Conflicting credentials are rejected.

Interfaces

REST

/api/amazon/*

GraphQL

/api/graphql

MCP

/api/mcp

REST reference

GET/api/amazon/product

Operation ID: get_AmazonProduct · response: data.amazonProduct

GET/api/amazon/product/gtin-from-asin

Operation ID: get_AmazonGtinFromAsin · response: data.amazonProduct

GET/api/amazon/product/asin-from-gtin

Operation ID: get_AmazonAsinFromGtin · response: data.amazonProduct

GET/api/amazon/product/variants

Operation ID: get_AmazonProductVariants · response: data.amazonProduct

GET/api/amazon/product/stock

Operation ID: get_AmazonStockEstimates · response: data.amazonProduct

GET/api/amazon/product/sales

Operation ID: get_AmazonSalesEstimates · response: data.amazonProduct

GET/api/amazon/product/reviews

Operation ID: get_AmazonProductReviews · response: data.amazonProduct

GET/api/amazon/product/offers

Operation ID: get_AmazonProductOffers · response: data.amazonProduct

GET/api/amazon/search

Operation ID: get_AmazonProductSearchResults · response: data.amazonProductSearchResults

GET/api/amazon/autocomplete

Operation ID: get_AmazonSearchAutocompleteResults · response: data.amazonSearchAutocompleteResults

GET/api/amazon/categories

Operation ID: get_AmazonProductCategoryTaxonomy · response: data.amazonProductCategoryTaxonomy

GET/api/amazon/category

Operation ID: get_AmazonProductCategory · response: data.amazonProductCategory

GET/api/amazon/seller

Operation ID: get_AmazonSeller · response: data.amazonSeller

GET/api/amazon/author

Operation ID: get_AmazonAuthor · response: data.amazonAuthor

GET/api/amazon/deals

Operation ID: get_AmazonDeals · response: data.amazonDeals

GET/api/amazon/bestsellers

Operation ID: get_AmazonBestSellers · response: data.amazonBestSellers

GET/api/amazon/bestseller-categories

Operation ID: get_AmazonBestSellerCategories · response: data.amazonBestSellerCategories

GraphQL

Send one query operation per request to /api/graphql. Variables use the same validation, marketplace semantics, quota, cache, and output contract as REST. Introspection and complexity are bounded by the gateway policy.

MCP

The JSON-RPC endpoint at /api/mcp exposes all seventeen operations as typed tools. Marketplace content is untrusted data and never tool instructions.

Agent Skill

The installable amazon-data Skill documents safe key setup, marketplace choice, pagination, cost awareness, freshness, and when to prefer REST, GraphQL, or MCP.