# ASIN402 Category Details

> ASIN402 Category Details is a paid API for AI agents from asin402.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns name, parent, children, product count, and sales-rank thresholds for Amazon category IDs across 11 marketplaces.

## Facts

- Endpoint: GET https://asin402.com/api/data/category?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/asin402-category-details-c04bad90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_17nypLCbtflF6dL7zILI7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability asin402-category-details-c04bad90
```

Example prompt: What's the name and full parent category tree for Amazon category ID 3375251 on the US marketplace? Include parents so I can see the full hierarchy.

## When to prefer this

Use this endpoint when you need to resolve Amazon category IDs to human-readable names, understand category hierarchy (parent/child relationships), or retrieve product count and sales-rank thresholds for a known category ID. It is the right choice when you already have category IDs (e.g. from a bestseller or product search endpoint) and need to enrich them with metadata. For discovering category IDs from a keyword, use the companion category search endpoint instead.

## Known failure modes

- Invalid or non-existent category ID returns empty or error response
- Requesting more than 10 category IDs at once may be rejected
- Unsupported marketplace domain code returns an error
- Missing required 'category' query parameter results in a 400-level error
- Insufficient credits/payment causes a 402 Payment Required response

## How this service works

Amazon category details. Name, parent, children, product count and sales-rank thresholds for category IDs. 1 credit per category; parents=1 adds the parent tree.

## Output

A JSON object containing a 'categories' map keyed by category ID, each entry including the category name, catId, and optionally its parent tree. Also includes metadata such as whether the response was cached, the price paid, and the marketplace domain ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "category"
     ],
     "properties": {
      "domain": {
       "type": "string",
       "description": "Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us."
      },
      "parents": {
       "enum": [
        0,
        1
       ],
       "type": "integer",
       "description": "1 = include the full parent tree. +1 credit per category."
      },
      "category": {
       "type": "string",
       "description": "Category ID or comma-separated list (up to 10). 0 = all root categories."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "_meta": {
       "type": "object",
       "properties": {
        "cached": {
         "type": "boolean"
        },
        "price_paid": {
         "type": "string"
        },
        "marketplace_domain_id": {
         "type": "integer"
        }
       }
      },
      "categories": {
       "type": "object",
       "properties": {
        "3375251": {
         "type": "object",
         "properties": {
          "name": {
           "type": "string"
          },
          "catId": {
           "type": "integer"
          }
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "_meta": {
   "cached": false,
   "price_paid": "$0.005",
   "marketplace_domain_id": 1
  },
  "categories": {
   "3375251": {
    "name": "Water Bottles",
    "catId": 3375251
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/asin402-category-details-c04bad90/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from asin402.com](https://www.zero.xyz/host/asin402.com/llms.txt)