US Customs Dataset Record Count for an HS Code (Import Records, america Dataset Only)

omnial/us-dataset-import-record-count

Counts the import records in the United States customs dataset (the one named "america") for one product (an HS code) within a date window, and returns that number as a single total. Use it to see how much US import data a product has before a deeper search. Only the count comes back: no companies, values, weights or individual records.

activeper callv1

Price

$0.001 per call

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/us-dataset-import-record-count" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/us-dataset-import-record-count" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/us-dataset-import-record-count", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/us-dataset-import-record-count", 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 call	$0.001

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "hsCode",
    "startDate",
    "endDate",
    "country",
    "catalog"
  ],
  "properties": {
    "hsCode": {
      "type": "string",
      "pattern": "^[0-9]{4,10}$",
      "description": "The product's customs HS code, 4 to 10 digits."
    },
    "catalog": {
      "enum": [
        "imports"
      ],
      "type": "string",
      "description": "The records counted; only \"imports\" (import records), the one tested, is offered."
    },
    "country": {
      "enum": [
        "america"
      ],
      "type": "string",
      "description": "The customs dataset counted; only \"america\" (the United States dataset), the one tested, is offered."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End of the date window, YYYY-MM-DD."
    },
    "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."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "How many import records in the United States dataset match the HS code and date window."
    }
  },
  "description": "The number of matching import records in the United States dataset."
}