开发者 API
获取有关 ImportGenius API 的详细信息
通过 API 集成 ImportGenius，使用我们的导入和导出数据构建强大的新工具、产品和解决方案。请在下方获取完整的详细信息，或与我们联系，以确定满足您业务需求的最佳解决方案。
我们提供什么
ImportGenius API 服务使您可以不受限制地访问任何独特用例的国际进出口装运记录
涵盖来自美国和亚洲、欧洲和拉丁美洲其他22个国家的数据。
历史贸易数据中最全面的数据库之一，记录了早在2006年的美国出货量。
最新的数据集之一。美国数据每天更新，周日除外。非美国数据每周更新一次，视可用性而定。
请求格式
https://data.importgenius.com/v2/shipments/?q ={查询}&access_token={accessToken}&country={国家}&type={类型}
查询结构
基本查询
结构
https://data.importgenius.com/v2/shipments?q =搜索字段+修饰语+搜索词&access_token=访问令牌&country=国家&type=类型
示例
https://data.importgenius.com/v2/shipments?q=shipname+exactly+adidas&access_token=example_token_123456789&country=us&type=im
仅限计数的查询
结构
&countonly=True
示例
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
多字查询
追加到任何结构
https://data.importgenius.com/v2/shipments?q =搜索字段+修饰语+搜索词&access_token=访问令牌&country=国家&type=类型
示例
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
通过邮政编码查询（仅限美国）
结构
https://data.importgenius.com/v2/shipments?q=zipcode+is +邮政编码&access_token=访问令牌&country=国家&type=类型
示例
https://data.importgenius.com/v2/shipments?q=zipcode+is+85258&access_token=example_token_123456789&country=us&type=im
通过邮政编码范围查询（仅限美国）
结构
https://data.importgenius.com/v2/shipments?q=zipcode+range+from +邮政编码来自+到+ZipCodeLast&access_token=访问令牌&country=国家&type=类型
示例
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
按日期范围查询
结构
https://data.importgenius.com/v2/shipments?q =搜索字段+修饰语+搜索词/日期+起始日期+开始日期+到+结束日期&access_token=访问令牌&country=国家&type=类型
示例
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
分页
在搜索条件之后追加
/page+from+页
示例
https://data.importgenius.com/v2/shipments?q=trademark+exactly+fjord/page+from+1&access_token=example_token_123456789&country=ru&type=im
有限制分页
在搜索条件之后追加
/page+from+页+限制+页数限制
示例
https://data.importgenius.com/v1/shipments?q=trademark+exactly+fjord/page+from+1+limit+5&access_token=example_token_123456789&country=ru&type=im
高级查询
在搜索条件之后追加
https://data.importgenius.com/v2/shipments?q =搜索字段+修饰语+搜索词/附加类型+搜索字段+修饰语+搜索词&access_token=访问令牌&country=国家&type=类型
示例
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
请求参数
参数
强制性的
类型
描述
访问令牌
Y
字符串
确认请求有效的访问令牌
国家
Y
字符串
将从中提取出货数据的国家。例如，输入 vn 为了越南。根据您的要求，我们的实施团队将在整合期间提供相关国家/地区代码清单。
类型
N
字符串
表示您是否在搜索导入， 我是，或者出口， 前，数据。默认情况下，如果未指定，则类型为导入。
搜索字段
Y
字符串
确定您要搜索的关键字的类别。例如，如果您想使用基于美国进口商名称的关键字进行搜索，则 SearchField 将是 consname。搜索字段的完整列表将在集成期间由我们的实施团队提供。
修饰语
Y
字符串
可以是以下任何值： 包含， 确切的， 任何， 以 start_with，或 以 ends_with
搜索词
Y
字符串
与您的搜索关键字相对应。例如，如果 搜索字段 是 产品， 搜索词 可以是 核桃
附加类型
N
字符串
可以是以下任何值： 和， 要么，或 不
仅计数
N
布尔值
如果留空，则默认值为 假的 这会触发 API 使用符合搜索条件的货件清单进行响应。将其设置为 真的 将仅返回符合搜索条件的货件数量。
邮政编码
N
布尔值
搜索的邮政编码覆盖范围。此功能仅支持美国配送
邮政编码来自
N
整数
如果通过范围进行搜索，则起始邮政编码。此功能仅支持美国配送
ZipCodeLast
N
整数
如果通过范围进行搜索，则结束邮政编码。此功能仅支持美国配送
开始日期
N
日期
搜索日期范围的开始日期
结束日期
N
日期
搜索日期范围的结束日期
页
N
整数
如果留空，回复将显示第一页。识别出页码后，它决定响应将来自哪一页。
例如，如果 页 是 4，默认为 页数限制 是 10，将返回第 31-40 行。
例如，如果 页 是 4，默认为 页数限制 是 10，将返回第 31-40 行。
页数限制
N
整数
可以将最大值设置为 10 和最小值为 1。如果留空，则默认值为 10。否则，指定的数字将决定结果中的行数。
返回参数
参数
类型
描述
总
字符串
可用行总数是您可以查询的数据总数
拿了
字符串
处理请求所花费的时间（以秒为单位）
日期范围
字符串
开始日期 从 和结束日期 到
行
物体
JSON 格式的货件清单数据，每次查询最多限于 10 行。每行都包含有关产品详细信息、公司详细信息以及通知信息等的精细信息。
sid
整数
字符串标识符
之前的余额
字符串
在处理请求之前您之前的信用总额
当前余额
字符串
处理请求后您当前的信用总额
反应
字符串
来自 ImportGenius 的重要通知，例如有关您的使用情况的提醒
当前余额
字符串
将响应发送回请求者所花费的总时间（以秒为单位）
准备好开始了吗？立即联系我们。
我们的客户服务和实施团队随时准备帮助您最大限度地提高ImportGenius体验。