{"uid":"cap_17nypLCbtflF6dL7zILI7","slug":"asin402-category-details-c04bad90","name":"ASIN402 Category Details","description":"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.","url":"https://asin402.com/api/data/category?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":["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"}}}}}}}}}}},"responseSchema":{"type":"json","example":{"_meta":{"cached":false,"price_paid":"$0.005","marketplace_domain_id":1},"categories":{"3375251":{"name":"Water Bottles","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_0SIrEXpONXjMoYpt7Fn5H","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":"Returns name, parent, children, product count, and sales-rank thresholds for Amazon category IDs across 11 marketplaces.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Mapping Amazon category hierarchy","prompt":"I have Amazon category ID 2619525 — can you look it up on the US marketplace and give me its name, all its child categories, and the full parent tree so I can understand where it sits in Amazon's hierarchy?"},{"title":"Bulk category label resolution","prompt":"I have a list of Amazon category IDs — 3375251, 2619526, and 7141123 — can you fetch their names and basic details all at once from the US marketplace so I can label my product database?"},{"title":"Exploring Amazon Germany categories","prompt":"Can you pull the details for Amazon category ID 3375251 on the German marketplace, including its name and parent categories?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:47.457Z","isFirstParty":false,"canonicalSlug":"asin402-category-details-c04bad90"}