{"uid":"cap_09LiyZDkITycDnJG6x0z_","slug":"tradepulse-hs-code-classifier-d511734e","name":"TradePulse HS Code Classifier","description":"HS code classification for trade and customs agents. Returns the correct HS code from a product description for customs filing.","url":"https://tradepulse.theaslangroupllc.com/api/trade/classify?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["product"],"properties":{"lang":{"type":"string","description":"Response language code (en, zh, ja, de, fr, es, ar, hi, etc.)"},"product":{"type":"string","description":"Natural language product description — e.g. 'laptop computer', 'cotton t-shirts', 'industrial water pump'"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","errors":{"400":{"example":{"error":"product parameter required"},"description":"Invalid or missing parameter(s) — required: product. Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."},"402":{"description":"Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."},"500":{"example":{"error":"upstream_failed"},"description":"Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__HWyfpQUxXW8RcMdv4UG9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies a product description into the correct Harmonized System (HS) code for customs filing and trade compliance.","exampleAgentPrompt":"What's the correct HS code for 'wireless noise-cancelling over-ear headphones with Bluetooth 5.0 and a built-in microphone' so I can file the customs declaration for my shipment?","exampleUseCases":[{"title":"Classify imports for customs declaration","prompt":"I'm importing a batch of stainless steel food storage containers with airtight silicone seals - what HS code should I use on my customs form?"},{"title":"Verify tariff codes for new products","prompt":"We're launching a new product line of rechargeable lithium-ion power banks with LED displays - can you tell me the right HS code so we know what duties apply?"},{"title":"Batch classify inventory for compliance","prompt":"I need to classify these items for our trade records: cotton t-shirts, polyester jackets, and wool scarves - what are the HS codes for each one?"}],"resultDescription":"Returns the correct HS code (Harmonized System classification code) for the given product description, suitable for use in customs filings and trade documentation. May include chapter, heading, and subheading details.","failureModes":["Ambiguous product description resulting in multiple possible HS codes","Product description too vague to classify accurately","Unrecognized or novel product categories with no clear HS mapping","Payment failure or insufficient USDC balance ($0.15 per call)","API timeout or service unavailability"],"whenToPreferThis":"Use this endpoint when you need an authoritative HS code for a specific product description for customs filing, import/export declarations, or trade compliance purposes. Especially useful for agents automating customs workflows or duty calculations where an accurate tariff classification is the first required step. Pair with the TradePulse tariff rate lookup and landed cost calculator siblings for end-to-end trade cost computation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T19:11:26.627Z","isFirstParty":false,"canonicalSlug":"tradepulse-hs-code-classifier-d511734e"}