# ASIN402 Category Search

> ASIN402 Category Search 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).

Search Amazon categories by keyword to retrieve category IDs needed for bestseller lists, product finders, and deals feeds.

## Facts

- Endpoint: GET https://asin402.com/api/data/category-search?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-search-184d0912
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZoOwxZbBwbKKN01Vied4V

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-search-184d0912
```

Example prompt: Can you find the Amazon category ID for 'water bottles' on the US marketplace? I need the ID to pull bestseller and deals data.

## When to prefer this

Use this endpoint as a prerequisite step before calling ASIN402 bestsellers, product finder, or deals endpoints — whenever you have a human-readable category name and need the numeric category ID that those endpoints require. Prefer this over hardcoding category IDs, as it supports all 11 Amazon marketplaces and covers the full Amazon taxonomy.

## Known failure modes

- No matching categories found for the given keyword — empty categories object returned
- Invalid domain value supplied — defaults to US or returns an error
- Term too vague or too specific returns irrelevant or zero results
- Network timeout or upstream Amazon data unavailability
- Credit balance exhausted — payment required before call succeeds

## How this service works

Find Amazon category IDs by name. Search categories by keyword to get the IDs needed by bestsellers, finder and deals. 1 credit.

## Output

Returns a JSON object with a 'categories' map keyed by category ID, each entry containing the category name and numeric catId, plus metadata about caching status, price paid, and 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": [
      "term"
     ],
     "properties": {
      "term": {
       "type": "string",
       "description": "Category name keywords, e.g. water bottles."
      },
      "domain": {
       "type": "string",
       "description": "Amazon marketplace: us, uk, de, fr, jp, ca, it, es, in, mx, br. Default us."
      }
     }
    }
   },
   "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": "Sports & Outdoors",
    "catId": 3375251
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/asin402-category-search-184d0912/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)