Import Export Data API - ImportGenius Bill of Lading Shipments

Search import and export shipment records, bills of lading and customs declarations, from the ImportGenius Trade Data API with your own access token, and get every record as a clean dataset row.

Works with the official ImportGenius Trade Data API on data.importgenius.com (GET /v2/shipments). ImportGenius covers more than 3.3 billion shipment records from customs and manifest data in 25+ countries. Search a country's imports or exports by product description, importer or consignee name, shipper name, trademark or any other search field on your plan, combine conditions with and, or and not, narrow to a date range, find US importers by zip code or zip code range, or just count the matches. Download as JSON, CSV or Excel, schedule it, or feed it into supplier discovery, competitor sourcing analysis, lead generation, brand protection, CRM enrichment, Power BI, Google Sheets and AI agents. Bring your own API key.

BYOK, not live-tested: the endpoint, parameters and query grammar come from ImportGenius's published API page (w3.importgenius.com/features/api-integration), and the /v2/shipments route was confirmed to exist on data.importgenius.com, but the actor has not been run against a live ImportGenius subscription.

What it does

• Field search: searchField modifier term, exactly as the API documents it. Documented fields include product (product description), consname (US importer or consignee), shipname (shipper) and trademark; your ImportGenius integration lists the rest, and the actor accepts any of them.
• Five match modifiers: contains, exactly, any, starts_with and ends_with.
• Advanced conditions: add up to 10 extra conditions joined with and, or or not, such as "and consname contains acme" or "not product contains used".
• Imports or exports, by country: choose the customs dataset by its two letter code (us, vn, in, ru and the others on your plan) and the trade direction.
• Date range: only shipments between two dates.
• US zip code search: importers at one zip code or across a zip code range.
• Count only: one row with the number of matching shipments, to size a market or a supplier before you pull records.
• Automatic paging: ImportGenius returns at most 10 rows per request; the actor pages until your row ceiling, the last page or the total number of matches.
• Every field kept: each record keeps all the fields ImportGenius returns (for US imports these include HS code and product description, importer, consignee and shipper with addresses, notify party, arrival date, quantity, weight, foreign and US ports, vessel, voyage, bill of lading number, containers and carrier), under ImportGenius's own field names.
• Pay only for results: refused and empty searches are recorded as a free row that says why, never charged.

How to get an access token

ImportGenius issues API access tokens, not self-served. API access is included with ImportGenius Enterprise (Global Enterprise) plans and is available as an upgrade on Business plans such as USA Pro, US-Mexico Pro and North America Pro. Request a demo or contact sales on importgenius.com; the implementation team configures your access, sends the token and gives you the list of search fields and country codes your plan covers. Paste the token into the Access token field. It is sent only to data.importgenius.com as the access_token parameter the API requires and is never logged.

Every API request spends credits on your ImportGenius plan (each answer reports your balance before and after), so keep Maximum results small while you test.

Input

Field	Description
queryType	keyword (field search, default), zipCode or zipRange (US only)
searchField	Field search: product (default), consname, shipname, trademark or another field on your plan
modifier	Field search: contains (default), exactly, any, starts_with, ends_with
searchTerm	Field search: the keyword, company name or brand
zipCode	US zip code search: five digits, such as 85258
zipCodeFrom, zipCodeTo	US zip code range search
extraConditions	Up to 10 lines as additionType field modifier term, such as and consname contains acme
country	Two letter dataset code, such as us, vn, in or ru. Default us
tradeType	im imports (default) or ex exports
startDate, endDate	Optional date range as YYYY-MM-DD, both or neither
countOnly	Return only the number of matches
maxResults	Row ceiling for the run (default 10, one request)
requestsPerMinute	Pacing, default 30
apiKey	Your ImportGenius access token (or the DATA_API_KEY secret)

Example: US imports of walnuts from one shipper in the first quarter of 2026.

{
    "queryType": "keyword",
    "searchField": "product",
    "modifier": "contains",
    "searchTerm": "walnuts",
    "extraConditions": ["and shipname contains farms"],
    "country": "us",
    "tradeType": "im",
    "startDate": "2026-01-01",
    "endDate": "2026-03-31",
    "maxResults": 50
}

This becomes the documented request GET /v2/shipments?q=product+contains+walnuts/and+shipname+contains+farms/date+from+2026-01-01+to+2026-03-31/page+from+1+limit+10&country=us&type=im, with the token added.

Example output

An illustrative row. The first columns are added by the actor; after them comes every field of the record exactly as ImportGenius returns it (only three are shown, named after the documented search fields). Values are an example only, not real data, and ImportGenius does not publish its row schema.

{
    "recordType": "shipment",
    "country": "us",
    "tradeType": "im",
    "query": "product contains walnuts/page from 1 limit 10",
    "page": 1,
    "position": 1,
    "totalMatches": 1843,
    "dateFrom": "2026-01-01",
    "dateTo": "2026-03-31",
    "found": true,
    "note": null,
    "retrievedAt": "2026-10-17T09:00:00.000Z",
    "consname": "EXAMPLE FOODS INC",
    "shipname": "EXAMPLE NUT FARMS LTD",
    "product": "SHELLED WALNUTS 25 KG BAGS"
}

A count only search returns one row with recordType set to count, totalMatches and the date range.

FAQ

What is the ImportGenius Trade Data API?

The ImportGenius Trade Data API is the enterprise REST API of ImportGenius (Trade Data Services Inc.), a US trade intelligence company that compiles customs and bill of lading records. Its shipments endpoint on data.importgenius.com returns import and export shipment manifest data as JSON, at most 10 rows per request, from more than 3.3 billion records in 25+ countries, authenticated with an access token.

Do I need my own ImportGenius access token?

Yes. This is a bring-your-own-key actor: it calls ImportGenius with your token, under your ImportGenius agreement and on your plan's credits. A missing or rejected token, or a request outside your plan, ends the run cleanly with a status message explaining what to change, and nothing is charged.

Which search fields can I use?

ImportGenius documents product, consname (the US importer or consignee name), shipname (the shipper name) and trademark in its examples and gives each customer the complete list for their plan during integration. The actor accepts any lower case field name and passes it to the API, which refuses fields your plan does not have.

Which countries are covered?

ImportGenius advertises import and export data for 25+ countries, including US imports and exports from bills of lading and customs data for countries such as Vietnam, India and Russia. Which country codes you can query depends on your plan.

How do I find a company's suppliers or customers?

Search US imports with searchField consname and the company name to see who ships to it (the shipper column), or searchField shipname and a supplier name to see whom it ships to. Add a date range to see recent activity, or use count only first to see how many shipments match.

How many rows can I get?

As many as your row ceiling and your ImportGenius credits allow. The API returns at most 10 rows per request, so 100 rows take 10 requests. The actor stops at the total number of matches the API reports.

What do I pay?

Pay per result: 0.01 USD per shipment record, or per count only answer. Refused and empty searches are never charged. Your ImportGenius subscription and its API credits are billed separately by ImportGenius.

Pricing

Event	Price	Charged for
shipment-record	0.01 USD	Each shipment record returned, or one count only answer

Keyword map

import export data API, bill of lading data, bill of lading API, customs data API, shipment data API, ImportGenius API, ImportGenius Trade Data API, US import data, export data, trade data API, importer database, supplier search, find suppliers, find buyers, consignee search, shipper search, HS code search, container shipment data, vessel and port data, competitor sourcing, supply chain intelligence, brand protection, trade data for AI agents.

Terms and data use

ImportGenius API access is governed by your separate commercial agreement with ImportGenius, which its website Terms of Use say takes precedence for subscribers. The public Terms of Use for the website are strict: they prohibit selling, transferring, licensing, distributing or publicly displaying ImportGenius content, and say that use or posting of any content on any other website or in a networked computer environment, for any purpose, is prohibited. Treat the shipment records as licensed to you for your own internal use, do not resell or republish them, check your ImportGenius agreement before storing results in shared systems or sharing them with third parties, and delete copies if your access ends. Every request spends credits on your plan. This actor is not affiliated with or endorsed by ImportGenius or Trade Data Services Inc.