Scope
A bounded query names the marketplace, page, limit, and filters.
They search the web. Glade searches Amazon. Send one validated query to a selected marketplace, keep filters and placement explicit, and receive normalized products your application can reason about. The same contract spans every supported storefront.
One discovery contract across Glade's most-used Amazon APIs
Watch a single product query move through the contract: scoped, validated, routed to the right storefront, acquired, normalized, and returned with explicit metadata.
mechanical keyboard
US · page 1 · limit 10
A bounded query names the marketplace, page, limit, and filters.
Unsupported parameters stop before upstream work begins.
The domain selects the Amazon host, locale, and currency context.
The relevant discovery surface is fetched under one cache policy.
Products, placement, prices, and pagination enter one contract.
Data and request metadata return through the same envelope.
Three moves turn a bounded search phrase into comparable product data.
Search term, marketplace, sort order, price, rating, condition, page, and limit are checked before provider work begins.
The selected domain resolves the Amazon host, locale, currency, and deterministic acquisition context for that request.
Identity, price, rating, placement, sponsored state, pagination, cache state, and request metadata share one response envelope.
Every field here belongs to the public request or response contract. See the API reference for the complete schema.
The advantage is the integration: validation, marketplace routing, acquisition, normalization, and explicit freshness metadata behind one operation surface.
BOUNDED VALIDATION
Every parameter has an explicit type and range. Invalid work is rejected before it can consume provider capacity or usage.
MARKET ROUTING
Thirteen storefronts map to the correct host, locale, currency, and ranking context without leaking that branching into your app.
CANONICAL OUTPUT
Volatile source markup is translated into stable products, placement, prices, ratings, filters, and page metadata.
CACHE + OBSERVABILITY
Freshness policy, cache state, request metadata, logs, quotas, and consistent failures travel with the same operation contract.
“The moat is the contract: marketplace volatility goes in, predictable product data comes out.”
General search APIs are excellent at the open web. Glade is a different data product: normalized commerce discovery with explicit marketplace context.
| How they compare | Glade | Open-web search |
|---|---|---|
| What it searches | Amazon product and discovery surfaces | Public web pages and documents |
| What a result is | A normalized product card with marketplace context | A web page, snippet, or document |
| How results rank | Amazon placement, filters, category, and sponsored state | Links, text relevance, and page authority |
| Marketplace context | Host, locale, currency, and storefront stay explicit | No commerce-specific storefront model |
| Output | Validated products, pagination, cache state, and request metadata | A list of links or extracted text |
What it searches
Amazon product and discovery surfaces
Open-web searchPublic web pages and documents
What a result is
A normalized product card with marketplace context
Open-web searchA web page, snippet, or document
How results rank
Amazon placement, filters, category, and sponsored state
Open-web searchLinks, text relevance, and page authority
Marketplace context
Host, locale, currency, and storefront stay explicit
Open-web searchNo commerce-specific storefront model
Output
Validated products, pagination, cache state, and request metadata
Open-web searchA list of links or extracted text
Open one of Glade's allowlisted Amazon search examples, run the live request, then inspect the normalized response before you integrate.
{
"success": true,
"data": {
"results": [
{
"asin": "B0EXAMPLE1",
"title": "Example mechanical keyboard",
"price": {
"value": 89.99,
"currency": "USD",
"display": "$89.99"
},
"rating": 4.7
}
],
"pageInfo": {
"currentPage": 1,
"hasNextPage": true
}
}
}Get an API key to run your own requests
Inputs are selected from documented presets. Production calls use the same validation and normalized response contract.
Amazon's hosts, currencies, locales, ranking surfaces, and page markup vary by storefront. Before your application sees a result, Glade normalizes identity, price, rating, placement, sponsored state, pagination, and request metadata into one canonical contract.
See how the unified schema worksNumbers reflect the documented Universal Search surface and the marketplace context carried by every request.
Can't find what you're looking for? Talk to our team.
Web search APIs discover public pages. Glade Universal Search reads Amazon product and discovery surfaces in a selected marketplace, then returns normalized product cards, placement, filters, pagination, cache state, and request metadata. It is a commerce-data contract, not a general web index.
No. Each request names one marketplace so host, locale, currency, and ranking context stay unambiguous. The same validated request and response contract works across all 13 supported marketplaces.
Product search, autocomplete, deals, best sellers, best-seller categories, category taxonomy, and category results share the same authentication, marketplace model, error conventions, and response envelope.
Yes. The normalized search result preserves placement context so downstream products can reason about sponsored and organic positions without scraping page markup.
Yes. The public examples use fixed, allowlisted parameters and run through the protected server-side playground proxy. Production requests require an organization-scoped API key.
Yes. Every interface maps to the same search operation, validation, cache policy, usage ledger, and normalized Amazon domain model.
Choose a marketplace and send one bounded request from your code. The same operation, validation, and normalized response across every supported storefront.
curl "https://gladeapi.com/api/amazon/search?searchTerm=mechanical%20keyboard&domain=US&page=1&limit=10" \
-H "API-KEY: glade_live_YOUR_API_KEY"