Endpoint Playground

Try the Costco categories API

Returns Costco category slugs and product counts relevant to an optional search term, each slug usable directly with GET /costco/search's category filter. Public data sourced from Costco's own search backend.

What a live request returned

14 Oct 2026: 50 categories; 3 fields had a value in every checked item.

Observed request: GET /costco/categories?query=refrigerator
Fields with a value in every checked item: slug, name, count

Sample value profiles: count: 4 to 408, median 13; name: “Appliances” and 49 other values.

Request: GET /costco/categories
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 2.49 s
Monitored request: GET /costco/categories?query=refrigerator

Costco categories API documentation Costco platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/costco/categories' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	No		Search text to scope the returned categories to, e.g. \

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "refrigerator",
    "categories": [
      {
        "slug": "compact-refrigerators",
        "name": "Compact Refrigerators",
        "count": 8
      },
      {
        "slug": "french-door-refrigerators",
        "name": "French Door Refrigerators",
        "count": 54
      }
    ]
  }
}

More Costco endpoints

Get a Costco product's detail Get a Costco product's delivery estimate Get a Costco product's reviews Search Costco products Find nearby Costco warehouses

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestcostco.categoriesResponseDocCostco

GET /costco/categories

Get Costco category facets

Response behavior

- This is a **query-scoped** category breakdown, not a claim of Costco's complete category taxonomy — Costco's own backend caps the category facet list at roughly 50 entries regardless of query, the same limit its own site's "Show more options" filter sidebar is bound by. - `name` is derived by title-casing each category `slug`'s hyphen-separated words (e.g. `compact-refrigerators` -> `"Compact Refrigerators"`), confirmed to reproduce Costco's own category display text.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "refrigerator",
    "categories": [
      {
        "slug": "compact-refrigerators",
        "name": "Compact Refrigerators",
        "count": 8
      },
      {
        "slug": "french-door-refrigerators",
        "name": "French Door Refrigerators",
        "count": 54
      }
    ]
  }
}

Endpoint Playground

Try the Costco categories API

What a live request returned

14 Oct 2026: 50 categories; 3 fields had a value in every checked item.

Observed request: GET /costco/categories?query=refrigerator
Fields with a value in every checked item: slug, name, count

Sample value profiles: count: 4 to 408, median 13; name: “Appliances” and 49 other values.

Request: GET /costco/categories
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 2.49 s
Monitored request: GET /costco/categories?query=refrigerator

Costco categories API documentation Costco platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/costco/categories' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	No		Search text to scope the returned categories to, e.g. \

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "refrigerator",
    "categories": [
      {
        "slug": "compact-refrigerators",
        "name": "Compact Refrigerators",
        "count": 8
      },
      {
        "slug": "french-door-refrigerators",
        "name": "French Door Refrigerators",
        "count": 54
      }
    ]
  }
}

More Costco endpoints

Get a Costco product's detail Get a Costco product's delivery estimate Get a Costco product's reviews Search Costco products Find nearby Costco warehouses

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestcostco.categoriesResponseDocCostco

GET /costco/categories

Get Costco category facets

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "refrigerator",
    "categories": [
      {
        "slug": "compact-refrigerators",
        "name": "Compact Refrigerators",
        "count": 8
      },
      {
        "slug": "french-door-refrigerators",
        "name": "French Door Refrigerators",
        "count": 54
      }
    ]
  }
}