{"uid":"cap_vFjuL8_SV4fxD4Rc8ztnB","slug":"tradepulse-hs-code-classifier-6ff4c457","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-five.vercel.app/api/trade/classify","method":"GET","headers":{},"bodySchema":{"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'"}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_1gyUni7FJYXJyOxqyL9uj","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 into its Harmonized System (HS) tariff code based on a natural language product description","exampleAgentPrompt":"What is the HS code for wireless Bluetooth noise-cancelling headphones with a built-in microphone?","exampleUseCases":[{"title":"Verify tariff codes for bulk imports","prompt":"I'm importing a shipment of stainless steel food containers and need to make sure I have the right HS codes for each item type before filing customs documentation."},{"title":"Classify new products for compliance","prompt":"We just added a line of cordless power drills to our product catalog and need to determine the correct harmonized system codes for our import declarations."},{"title":"Calculate duties on mixed shipment","prompt":"Can you help me figure out the HS codes for everything in this container? We've got LED lighting fixtures, plastic storage boxes, and aluminum cookware all mixed together."}],"resultDescription":"Returns the matched HS code (e.g. 8518.30) along with chapter, heading, and subheading details derived from the product description, enabling the caller to use the correct tariff classification for customs declarations, duty calculation, or trade compliance purposes.","failureModes":["Ambiguous product description leads to low-confidence or multiple candidate HS codes","Product description too vague to classify — returns error or generic top-level heading only","Unsupported product category returns no result","Rate limit or payment failure returns 402 Payment Required","Malformed request returns 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you have a product description and need to determine its HS/HTS tariff code for customs filing, duty calculation, or trade compliance. It is the right first step before calling tariff rate, landed cost, or FTA eligibility endpoints that require an HS code as input. Prefer this over manual lookup tables or static databases when you need fast, AI-driven classification from free-text product descriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:41.023Z","isFirstParty":false}