{"uid":"cap_2tjpgLHHYehb0TSMtqOA5","slug":"sitecheck-trade-energy-hs-code-classifier-60a7901f","name":"SiteCheck Trade & Energy – HS Code Classifier","description":"Finds Harmonized System (HS) codes from UN Comtrade's HS reference list by code prefix or description keyword: code, official description, hierarchy level. It lists candidate headings and subheadings; it does not decide the legal tariff code for a shipment.","url":"https://api.tradeenergy-api.workers.dev/api/logistics/hs-code-classifier?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":["q"],"properties":{"q":{"type":"string","description":"HS code digits (e.g. 8703) or a keyword (e.g. motor cars)"},"limit":{"type":"string","description":"1 to 20, default 5"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":4,"query":"motor cars","source":"https://comtradeapi.un.org/files/v1/app/reference/HS.json","matches":[{"leaf":false,"level":4,"hsCode":"8703","description":"Motor cars and other motor vehicles; principally designed for the transport of persons (other than those of heading no. 8702), including station wagons and racing cars"},{"leaf":true,"level":6,"hsCode":"401110","description":"Rubber; new pneumatic tyres, of a kind used on motor cars (including station wagons and racing cars)"}],"checkedAt":"2026-10-23T09:37:56.757Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NydroWOS-XhbGGUH1HLml","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches UN Comtrade's official HS reference list by code prefix or keyword to return candidate Harmonized System headings and subheadings with descriptions and hierarchy levels.","exampleAgentPrompt":"Can you search the UN Comtrade HS reference list for 'solar panels' and give me the top 5 candidate headings and subheadings with their official descriptions and hierarchy levels?","exampleUseCases":[{"title":"Export customs classification research","prompt":"I need to classify solar photovoltaic modules for an export shipment — can you search the UN Comtrade HS reference list for 'solar panel' and show me the top 5 candidate HS codes with their official descriptions?"},{"title":"Code prefix drill-down for import filing","prompt":"Look up all HS codes that start with the prefix 8703 in the Comtrade reference list so I can see what subheadings are available under motor cars."},{"title":"Trade compliance product lookup","prompt":"We're importing rubber tyres and need to identify possible HS headings — can you search the Comtrade HS list for 'pneumatic tyres' and return up to 10 matches with their hierarchy levels?"}],"resultDescription":"Returns a JSON object with the query string, total match count, source URL (UN Comtrade HS reference), checked timestamp, and an array of matches each containing the HS code, its official UN description, hierarchy level (e.g. 4 for heading, 6 for subheading), and a leaf flag indicating whether it is a terminal subheading.","failureModes":["No matches found for obscure or misspelled keywords — returns count 0 with empty matches array","Query too short or ambiguous may return unrelated headings spanning multiple chapters","Limit parameter out of range (outside 1–20) may default or return an error","UN Comtrade upstream data unavailable may cause timeout or 5xx error","HS code prefix with non-numeric characters returns no results"],"whenToPreferThis":"Choose this endpoint when you need to discover candidate Harmonized System codes from the authoritative UN Comtrade reference by either a numeric prefix or a plain-language product keyword. It is ideal for trade compliance research, export/import classification assistance, and supply chain tooling where you need official HS descriptions and hierarchy levels. It does not determine the legally binding tariff code for a specific shipment — use it as a shortlisting and research tool, not a final classification authority.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T04:06:23.835Z","isFirstParty":false,"canonicalSlug":"sitecheck-trade-energy-hs-code-classifier-60a7901f"}