Free tier · no payment method required

Best-seller categories API

Get best-seller category navigation for a marketplace. Call one documented GET endpoint across 13 Amazon marketplaces with the same API key, normalized response envelope, and production metadata.

Get an API key View Documentation

TL;DR

The Best-seller categories API returns structured JSON under data.amazonBestSellerCategories. It is available through REST, GraphQL, and MCP, with a 1 day cache policy and explicit request, freshness, rate-limit, and usage metadata.

Use this Glade operation through

REST API GraphQL MCP and agent Skill

Live demo

Try the Best-seller categories API in your browser

Run the allowlisted best-seller categories preset against the real Glade backend. Parameters are predefined and validated before an upstream request is made.

Try the Best-seller categories API

Run the predefined request before writing a single line

example response · ready

{
  "data": {
    "amazonBestSellerCategories": {
      "categories": [
        {
          "id": "172282",
          "name": "Electronics",
          "url": "https://www.amazon.com/gp/bestsellers/electronics"
        },
        {
          "id": "1055398",
          "name": "Home & Kitchen",
          "url": "https://www.amazon.com/gp/bestsellers/home-garden"
        }
      ]
    }
  }
}

Endpoint

What does the Best-seller categories API return?

The Best-seller categories operation is available through every Glade interface and resolves through the same validation and normalized output contract.

REST responseavailable

GET /api/amazon/bestseller-categories returns data.amazonBestSellerCategories in the standard response envelope.

GraphQL fieldavailable

amazonBestSellerCategories exposes the same normalized operation through the typed GraphQL schema.

MCP toolavailable

get_amazon_bestseller_categories exposes the allowlisted operation to compatible AI agents.

Developer First

How do you call the Best-seller categories API in seconds?

Use /api/amazon/bestseller-categories without maintaining marketplace-specific acquisition, parsers, retry rules, or response adapters.

One schema, every operation

Use this API alongside 16 other Glade operations without changing authentication or the response envelope.

Metadata, not guesswork

Every response includes request, cache, freshness, rate-limit, and usage metadata for production decisions.

See the contract before coding

Copy a request in Python, TypeScript, or cURL and inspect the example JSON before moving into production.

example response · ready

import requests

response = requests.get(
    'https://gladeapi.com/api/amazon/bestseller-categories',
    params={'domain': 'US'},
    headers={'API-KEY': 'glade_live_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "data": {
    "amazonBestSellerCategories": {
      "categories": [
        {
          "id": "172282",
          "name": "Electronics",
          "url": "https://www.amazon.com/gp/bestsellers/electronics"
        },
        {
          "id": "1055398",
          "name": "Home & Kitchen",
          "url": "https://www.amazon.com/gp/bestsellers/home-garden"
        }
      ]
    }
  }
}

Browse all 17 APIs

One API, 13 marketplaces

How does Glade normalize best-seller categories across Amazon marketplaces?

Amazon storefronts vary by host, currency, locale, delivery context, and available fields. Glade keeps those differences behind one versioned best-seller categories contract.

One schema, every marketplace

One documented contract.

13 Amazon storefronts use one marketplace code, validation layer, and output contract.

data.amazonBestSellerCategories marketplace: US success: true

Currency and locale included

Context stays attached.

Marketplace, currency, delivery context, request ID, cache state, and fetch time travel with the normalized response.

cache: HIT fetched_at: 2026-08-16T12:00:00Z usage_units: 1

REST, GraphQL, and MCP

One key, every interface.

Keep one server-side API key while application code and agents use the interface that fits their workflow.

REST: /api/amazon/bestseller-categories GraphQL: amazonBestSellerCategories MCP: get_amazon_bestseller_categories

Operation-level freshness

Caching fits the data.

This endpoint uses a 1 day cache policy so volatility and request cost stay explicit.

cache_ttl: 86400 rate_limit: documented request_id: glade_...

Get an API key

Glade Amazon API17 endpoints supported

View docs

GET/api/amazon/bestseller-categories?domain=US

domainUS

curl 'https://gladeapi.com/api/amazon/bestseller-categories?domain=US' \
  -H 'API-KEY: glade_live_YOUR_API_KEY'

example response · ready

{
  "data": {
    "amazonBestSellerCategories": {
      "categories": [
        {
          "id": "172282",
          "name": "Electronics",
          "url": "https://www.amazon.com/gp/bestsellers/electronics"
        },
        {
          "id": "1055398",
          "name": "Home & Kitchen",
          "url": "https://www.amazon.com/gp/bestsellers/home-garden"
        }
      ]
    }
  }
}

Compare

How does Glade's Best-seller categories API compare to a self-managed integration?

Glade packages best-seller categories acquisition, validation, normalization, caching, errors, and request metadata behind one server-side key.

FeatureGlade APISelf managed

AuthenticationOne API-KEY headerSource-specific credentials or sessions

Setup requiredCreate a key and call the endpointBuild acquisition, parsing, retries, and adapters

Marketplace support13 stores through one contractSeparate host and locale handling

Response schemadata.amazonBestSellerCategoriesSource-specific page structures

Freshness1 day policy with metadataYour team owns caching and observation time

InterfacesREST, GraphQL, MCP, and SkillYour team maintains each adapter

How is Best-seller categories API usage measured?

Successful normalized operations consume the units defined by the active plan. Request headers make usage and rate-limit state visible to your backend.

Can I use best-seller categories data in production?

Use public data, respect source rules and third-party rights, keep keys server-side, and match retention and downstream processing to your approved use case.

FAQ

Have a question? We got answers

Answers about this Glade API, its parameters, interfaces, freshness, and production use.

How do I call the Best-seller categories API?

Create a Glade key, send a GET request to /api/amazon/bestseller-categories with one of the documented identifier or query presets, and read data.amazonBestSellerCategories from the response envelope.

What does the Best-seller categories API return?

Get best-seller category navigation for a marketplace. Optional fields remain optional, and every response includes request and freshness metadata needed for production handling.

Which marketplaces support best-seller categories?

Use the same operation across 13 supported Amazon marketplaces by passing the documented domain code.

How fresh is best-seller categories data?

This operation uses a 1 day cache policy. Read the cache-state and data-fetched-at headers instead of inferring freshness from when your application received the response.

Can I use the Best-seller categories API with an AI agent?

Yes. The get_amazon_bestseller_categories MCP tool and generated documentation expose the same allowlisted operation and validation rules.

Can I use the Best-seller categories API in production?

Yes. Keep keys server-side, validate optional fields, store request IDs, use bounded retries for temporary failures, and review source rules and third-party rights for your use case.

Contract statistics

API contract at a glance

Current Best-seller categories details generated from Glade's versioned operation catalog.

marketplaces

1 day

cache policy

interfaces

Ready to call the Best-seller categories API?

Create a key, keep it server-side, and run the predefined request in minutes.

Get an API key