{"uid":"cap_ZoOwxZbBwbKKN01Vied4V","slug":"asin402-category-search-184d0912","name":"ASIN402 Category Search","description":"Find Amazon category IDs by name. Search categories by keyword to get the IDs needed by bestsellers, finder and deals. 1 credit.","url":"https://asin402.com/api/data/category-search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}}}}}},"responseSchema":{"type":"json","example":{"_meta":{"cached":false,"price_paid":"$0.005","marketplace_domain_id":1},"categories":{"3375251":{"name":"Sports & Outdoors","catId":3375251}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9XGXS_IoPcQx8WLtZOQYl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Amazon categories by keyword to retrieve category IDs needed for bestseller lists, product finders, and deals feeds.","exampleAgentPrompt":"Can you find the Amazon category ID for 'water bottles' on the US marketplace? I need the ID to pull bestseller and deals data.","exampleUseCases":[{"title":"Seeding a bestsellers pipeline","prompt":"I want to build a bestsellers report for 'coffee makers' on Amazon US — can you search for the category ID so I can pass it to the bestsellers endpoint?"},{"title":"Scoping deals feed by category","prompt":"I'm setting up an Amazon price-drop alert for kitchen gadgets — look up the category ID for 'kitchen gadgets' on the US marketplace so I can use it with the deals feed."},{"title":"Cross-marketplace category lookup","prompt":"What's the Amazon UK category ID for 'yoga mats'? I need it to run a product finder query on the UK marketplace."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:56.739Z","isFirstParty":false,"canonicalSlug":"asin402-category-search-184d0912"}