HS Codes Matching a Product Keyword in a Country's Import Records (First Row)

omnial/import-hs-codes-for-product-keyword

Given a product keyword, an importing country and a date window, searches that country's customs import records and returns how many HS code rows match, plus the first HS code row returned: the full HS code, its description in English and in Chinese, the total USD value, weight and quantity of the matching records under it, the average USD value per unit of weight and of quantity, the number of trade records, and that code's share of the total USD value.

activeper resultv1

Price

Up to $0.0219 per result; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Tendata

Data from Tendata.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/import-hs-codes-for-product-keyword" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/import-hs-codes-for-product-keyword" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/import-hs-codes-for-product-keyword", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/import-hs-codes-for-product-keyword", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per result Charged for every result returned	$0.0219

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "productDesc",
    "countryOfDestinationCode",
    "startDate",
    "endDate",
    "catalog",
    "pageNo",
    "pageSize"
  ],
  "properties": {
    "pageNo": {
      "enum": [
        1
      ],
      "type": "integer",
      "description": "The page number; only the first page (1) is offered."
    },
    "catalog": {
      "enum": [
        "imports"
      ],
      "type": "string",
      "description": "The records searched; only \"imports\" (import records), the one tested, is offered."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End of the date window, YYYY-MM-DD."
    },
    "pageSize": {
      "enum": [
        1
      ],
      "type": "integer",
      "default": 1,
      "description": "Rows per page; only 1, the one tested, is offered."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start of the date window, YYYY-MM-DD. The window may span at most three years."
    },
    "productDesc": {
      "type": "string",
      "minLength": 1,
      "description": "A product keyword matched against the goods descriptions in the records, in plain English (one keyword; the multi-keyword form was never tested)."
    },
    "countryOfDestinationCode": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "The importing (destination) country, as an ISO 3166 three-letter code."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "How many HS code rows the matching import records fall under."
    },
    "content": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "hsCode": {
            "type": "string",
            "description": "The HS code as recorded, at full national length (10 digits seen)."
          },
          "weight": {
            "type": "number",
            "description": "Total weight of the records, as recorded."
          },
          "quantity": {
            "type": "number",
            "description": "Total quantity of the records, as recorded."
          },
          "sumOfUSD": {
            "type": "number",
            "description": "Total value of the records, in USD."
          },
          "tradeCount": {
            "type": "number",
            "description": "Number of trade records."
          },
          "amountSharePct": {
            "type": "number",
            "description": "This code's share of the total USD value, as a fraction of 1."
          },
          "weightAvgPrice": {
            "type": "number",
            "description": "Average USD value per unit of weight (USD value divided by weight)."
          },
          "hsDescriptionCn": {
            "type": "string",
            "description": "The HS code's description in Chinese."
          },
          "hsDescriptionEn": {
            "type": "string",
            "description": "The HS code's description in English."
          },
          "quantityAvgPrice": {
            "type": "number",
            "description": "Average USD value per unit of quantity (USD value divided by quantity)."
          }
        }
      },
      "description": "The first HS code row returned (at most one)."
    }
  },
  "description": "The HS code roll-up: the count of matching code rows and the first row."
}