ShipSeeker API
Programmatic U.S. duty & landed-cost lookups for brokers, forwarders, and ops teams. Drop real tariff math into your quoting tools, ERP, or spreadsheets — JSON in, JSON out.
Included with the Business plan ($199/mo). Get your key on your account page.
📥 OpenAPI spec (openapi.json) — import into Postman, Insomnia, or Swagger UI.
Authentication
Pass your key as a query parameter ?key=ss_live_… or a bearer header Authorization: Bearer ss_live_…. All responses are JSON; errors use standard HTTP status codes.
Rate limit: 120 requests/minute per key. Every response includes X-RateLimit-Remaining; exceeding it returns 429.
Endpoints
GET /api/v1/duty
Duty + Section 301 + CBP fees + landed cost for one HTS code & origin.
Params: hts (required), value, origin (china, mfn, mx, ca, kr, … or col2), s301 (25/7.5/none), ocean (1).
curl "https://shipseeker.xyz/api/v1/duty?hts=8507.60.00&value=50000&origin=china&s301=25&ocean=1&key=YOUR_KEY"
GET /api/v1/hts/{code}
HTS classification & rate schedule (general / special / column 2).
curl "https://shipseeker.xyz/api/v1/hts/8507.60.00?key=YOUR_KEY"
GET /api/v1/exporters?hts={code}
Largest exporting countries of the product's HS2 chapter (UN Comtrade).
curl "https://shipseeker.xyz/api/v1/exporters?hts=8507&limit=10&key=YOUR_KEY"
POST /api/v1/duty/bulk
Cost a whole PO in one call (up to 1,000 lines). CBP fees (MPF/HMF) are applied once per entry to the combined value.
curl -X POST "https://shipseeker.xyz/api/v1/duty/bulk?key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"s301":"25","ocean":true,"items":[
{"hts":"8507.60.00","value":50000,"origin":"china"},
{"hts":"9403.60","value":24000,"origin":"vietnam"}
]}'
Notes
Estimates use USITC general, FTA-preference & Section 301 rates plus CBP fee formulas. Specific/compound-rate lines return "specific_rate": true with a null duty. AD/CVD duties are not included and FTA preference requires rules-of-origin — verify with a licensed customs broker before filing.