Developer API
Get details on ImportGenius API
Integrate ImportGenius via an API to build powerful new tools, products, and solutions using our import & export data. Get the complete details below, or speak with us to identify the best solution for your business needs.
What we offer
ImportGenius API service gives you unrestricted access to international import & export shipment records for any of your unique use cases
Covers data from the US and 22 other countries across Asia, Europe, and Latin America.
One of the most comprehensive database of historic trade data, capturing US shipments as far back from 2006.
One of the most updated datasets. US data updated everyday except Sundays. Non-US data updated every week, subject to availability.
Request format
https://data.importgenius.com/v2/shipments/?q={query}&access_token={accessToken}&country={country}&type={type}
Query structure
Basic query
Structure
https://data.importgenius.com/v2/shipments?q=searchField+modifier+searchTerm&access_token=accessToken&country=country&type=type
Example
https://data.importgenius.com/v2/shipments?q=shipname+exactly+adidas&access_token=example_token_123456789&country=us&type=im
Count-only query
Structure
&countOnly=true
Example
https://data.importgenius.com/v2/shipments?q=shipname+exactly+adidas&accesshttps://data.importgenius.com/v2/shipments?q=product+contains+walnuts&access_token=example_token_123456789&country=in&type=im&countOnly=true
_token=example_token_123456789&country=us&type=im
_token=example_token_123456789&country=us&type=im
Multi-word query
Append to any Structure
https://data.importgenius.com/v2/shipments?q=searchField+modifier+searchTerm&access_token=accessToken&country=country&type=type
Example
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
Query via zip code (US only)
Structure
https://data.importgenius.com/v2/shipments?q=zipcode+is+zipCode&access_token=accessToken&country=country&type=type
Example
https://data.importgenius.com/v2/shipments?q=zipcode+is+85258&access_token=example_token_123456789&country=us&type=im
Query via zip code range (US only)
Structure
https://data.importgenius.com/v2/shipments?q=zipcode+range+from+zipCodeFrom+to+zipCodeLast&access_token=accessToken&country=country&type=type
Example
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
Query with date range
Structure
https://data.importgenius.com/v2/shipments?q=searchField+modifier+searchTerm/date+from+startDate+to+endDate&access_token=accessToken&country=country&type=type
Example
https://data.importgenius.com/v2/shipments?q=shipname+exactly+adidas/date+from+2023-01-27+to+2023-01-28&access_token=example_token_123456789&country=us&type=im
Pagination
Append after the search criteria
/page+from+page
Example
https://data.importgenius.com/v2/shipments?q=trademark+exactly+fjord/page+from+1&access_token=example_token_123456789&country=ru&type=im
Pagination with limit
Append after the search criteria
/page+from+page+limit+pageLimit
Example
https://data.importgenius.com/v1/shipments?q=trademark+exactly+fjord/page+from+1+limit+5&access_token=example_token_123456789&country=ru&type=im
Advanced query
Append after the search criteria
https://data.importgenius.com/v2/shipments?q=searchField+modifier+searchTerm/additionType+searchField+modifier+searchTerm&access_token=accessToken&country=country&type=type
Example
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
Request parameters
Parameter
Mandatory
Type
Descrption
accessToken
Y
String
Access token that confirms the request is valid
country
Y
String
Country where the shipment data will be pulled from. For example, enter vn for Vietnam. Depending on your requirements, a list of relevant country codes will be provided by our implementation team during integration.
type
N
String
Indicates if you are searching for import, im, or export, ex, data. By default, the type is import when not indicated.
searchField
Y
String
Determines the category of a keyword that you are searching for. For example, if you want to search using a keyword based on an importer’s name in the US, the searchField will be consname. The complete list of search fields will be provided by our implementation team during integration.
modifier
Y
String
Can be any of the following values: contains, exactly, any, starts_with, or ends_with
searchTerm
Y
String
Corresponds to your search keyword. For example, if the searchField is product, the searchTerm can be walnuts
additionType
N
String
Can be any of the following values: and, or, or not
countOnly
N
Boolean
If left blank, the default value is false which triggers the API to respond with the list of shipments that match the search criteria. Setting it to true will return only the count of shipments that match the search criteria.
zipCode
N
Boolean
Zip code coverage of the search. This feature is supported for US Shipments only
zipCodeFrom
N
Integer
Starting zip code if searching via a range. This feature is supported for US Shipments only
zipCodeLast
N
Integer
Ending zip code if searching via a range. This feature is supported for US Shipments only
startDate
N
Date
Starting date of a search’s date range
endDate
N
Date
Ending date of search’s date range
page
N
Integer
If left blank, the response will show you the first page. When the page number is identified, it determines from which page the response will be.
For example, if page is 4 and the default pageLimit is 10, Rows 31-40 will be returned.
For example, if page is 4 and the default pageLimit is 10, Rows 31-40 will be returned.
pageLimit
N
Integer
Can be set to a maximum value of 10 and minimum value of 1. If left blank, the default value is 10. Otherwise, the number specified will determine the number of rows in the result.
Return parameters
Parameter
Type
Descrption
total
String
Total number of available rows that of data that you can query
took
String
Amount of time it took to process the request (in seconds)
dateRange
String
Starting date from and end date to
rows
Object
Shipment manifest data in JSON Format, limited to a maximum of 10 rows per query. Each row contains granular information about the product details, company details, and notify information among others.
sid
Integer
String identifier
previous_balance
String
Your previous credit total before the request was processed
current_balance
String
Your current credit total after the request was processed
response
String
Important notifications from ImportGenius, such as reminders about your utilization
current_balance
String
Total amount of time it took before a response was sent back to the requestor (in seconds)
Ready to get started? Get in touch with us today.
Our customer care and implementation teams are ready to help maximize your ImportGenius experience.