1. Customs Record Search
TradeWind AI API 2.0 Documentation
🇺🇸 English
  • 🇨🇳 简体中文
  • 🇺🇸 English
  • TradeWind AI API 2.0
    • Reference
      • (Agent) Country and Language Codes Reference (No authentication required)
      • (Waterfall) Retrieve Industry references
      • (Waterfall) Retrieve Technology technical references
    • Agentic Tasks
      • (Agent) Task Creation
      • (Agent) Task List
      • (Agent) Task Data
    • (Waterfall) Company Search
      • (Waterfall) Company Search
      • (Waterfall) Company Enrichment
    • (Waterfall) People Search
      • (Waterfall) Contact Search
      • (Waterfall) Contact Enrichment
    • Email Verificatioin
      • Batch Task Result Query (Email Verification)
    • Customs Record Search
      • (Customs) Country Reference
        GET
      • Retrieve customs data list
        POST
      • Retrieve list of customs companies
        POST
      • Retrieve a company's customs status
        POST
      • Retrieve customs company details
        POST
      • Retrieve customs company trade trends
        POST
      • Retrieve a company's customs import and export records
        POST
      • Retrieve customs trade partner records for a company
        POST
      • Retrieve customs HS code records for companies
        POST
      • Retrieve list of products purchased or supplied by a customs company
        POST
      • Retrieve trade regions for a customs company
        POST
      • Retrieve statistics for customs, companies, and trade ports
        POST
      • (Customs) Intelligent Mail Search (Legacy)
        POST
      • List of companies matching the company name
        POST
      • List of contacts matched to the company
        POST
      • Retrieve customs procurement trends
        POST
      • Retrieve global customs regional distribution map
        POST
      • Retrieve customs transactions for Chinese suppliers
        POST
      • Retrieve customs merchant transactions
        POST
      • Retrieve Customs Merchant Transactions (New)
        POST
    • Health
      • GET API liveness probe
    • Metrics
      • GET API Operational Metrics
  1. Customs Record Search

Retrieve customs data list

POST
{{baseUrl}}/api/customs/search
Last modified:2026-07-16 18:33:00
Retrieve a list of customs data.

Request

Header Params

Body Params application/json

Example
{
  "start_time": "2024-11-27",
  "end_time": "2025-11-27",
  "product": "toy",
  "hscode": "",
  "tradeCode": "",
  "exporter_country": "",
  "importer_country": "",
  "buyer": "",
  "seller": "",
  "departure_port": "",
  "buyer_port": "",
  "limit": 10,
  "page": 2,
  "recordType": "",
  "exclude_logistics": "",
  "exclude_type": ""
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '{{baseUrl}}/api/customs/search' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "start_time": "2024-11-27",
  "end_time": "2025-11-27",
  "product": "toy",
  "hscode": "",
  "tradeCode": "",
  "exporter_country": "",
  "importer_country": "",
  "buyer": "",
  "seller": "",
  "departure_port": "",
  "buyer_port": "",
  "limit": 10,
  "page": 2,
  "recordType": "",
  "exclude_logistics": "",
  "exclude_type": ""
}'

Responses

🟢201已创建
application/json
Bodyapplication/json

Example
{
  "success": true,
  "request_id": "req_lsfaaxapxZMY",
  "meta": {
    "total_results": 100000,
    "page": 1,
    "per_page": 20,
    "total_pages": 5000,
    "has_more": true,
    "billing": {
      "credits_charged": 2.72,
      "byok_used": false
    }
  },
  "records": [
    {
      "id": "xf_cust_0",
      "snow_flake_id": "1EYczpoBRoKknSgQmYCk",
      "source_id": 2,
      "product_desc": "PO            ITEM       ;PLUS TOYS HTS #:",
      "hs_code": "",
      "hs_product": "",
      "declaration_number": "OOLU2162600200",
      "manifest_number": "OOLU2162600200",
      "billing_no": "",
      "importer_id": "910399153478213632",
      "exporter_id": "0",
      "foreign_port": "57037           Yangshan, China",
      "local_port": "5201 Charlotte Amalie, Virgin Islands",
      "place_of_receipt": "SHANGHAI",
      "fob": "0.00",
      "fob_unit": null,
      "cif": "0.00",
      "cif_unit": null,
      "weight": "12617.000",
      "weight_unit": "KG",
      "quantity": 7393,
      "qty_unit": "CTN",
      "measurement": "1.0",
      "measurement_unit": "CTN",
      "vessel_name": "APL SALALAH",
      "container_number": "OOCU6812553",
      "transport": "VESSEL, containerized",
      "carrier": "OOLU",
      "container_size": null,
      "recordtype": "Import",
      "flight_no": "0XR99",
      "date": 1764172800,
      "updatetime": "1764412854",
      "importer_company_name": "WALGREEN CO",
      "exporter_company_name": "",
      "notify_party_name": "",
      "notify_address": "",
      "date_text": "2025-11-27",
      "exporterCountry": null,
      "importerCountry": null,
      "originCountry": null,
      "seller": null,
      "buyer": {
        "snow_flake_id": "910399153478213632",
        "outside_join_ids": "5fd1a8bdf7611900013e1e07",
        "outside_site_id": null,
        "name": "WALGREEN CO",
        "email": null,
        "phone": null,
        "website_url": null,
        "primary_domain": null,
        "raw_address": null,
        "short_description": null,
        "country": "75",
        "updatetime": "1776792684",
        "status": "normal",
        "matchtime": "0",
        "have_embedding": 1,
        "status_text": "Normal"
      },
      "origin_country": null,
      "importer_country": {
        "id": 75,
        "name": "United States",
        "en": "United States\n",
        "map_en": "the United States",
        "name_list": "United States,U.S.A,UNITED STATES,UNITED STATES OF AMERICA,СОЕДИНЕННЫЕ ШТАТЫ,USA,ESTADOS UNIDOS DE NORTEAMERICA",
        "iso_code": "us",
        "logo": "http://ai.keep1.net/uploads/country/us.png",
        "createtime": "1691472821",
        "updatetime": "1691472821",
        "status": "normal",
        "status_text": "Normal"
      },
      "exporter_country": {
        "id": 140,
        "name": "China",
        "en": "China",
        "map_en": "China",
        "name_list": "China,КИТАЙ,República Popular de China",
        "iso_code": "cn",
        "logo": "http://ai.keep1.net/uploads/country/cn.png",
        "createtime": "1691472821",
        "updatetime": "1691472821",
        "status": "normal",
        "status_text": "Normal"
      },
      "seller_name": null,
      "buyer_name": "WALGREEN CO",
      "origin_country_name": null,
      "importer_country_name": "United States",
      "exporter_country_name": "China",
      "origin_country_logo": null,
      "importer_country_logo": "http://ai.keep1.net/uploads/country/us.png",
      "exporter_country_logo": "http://ai.keep1.net/uploads/country/cn.png"
    },
    {
      "id": "xf_cust_1",
      "snow_flake_id": "ZUYczpoBRoKknSgQmX6e",
      "source_id": 2,
      "product_desc": "PLASTIC TOYS HTS:",
      "hs_code": "",
      "hs_product": "",
      "declaration_number": "EXDO61N0921743",
      "manifest_number": "EXDO61N0921743",
      "billing_no": "EXDO61N0921743",
      "importer_id": "910400456491069440",
      "exporter_id": "1039598798690041856",
      "foreign_port": "57078           Yantian, China",
      "local_port": "1801 Tampa, Florida",
      "place_of_receipt": "YANTIAN",
      "fob": "0.00",
      "fob_unit": null,
      "cif": "0.00",
      "cif_unit": null,
      "weight": "25.000",
      "weight_unit": "KG",
      "quantity": 7,
      "qty_unit": "CTN",
      "measurement": "0.0",
      "measurement_unit": "CTN",
      "vessel_name": "ZIM ANTWERP",
      "container_number": "SEGU5763508",
      "transport": "VESSEL, containerized",
      "carrier": "EXDO",
      "container_size": null,
      "recordtype": "Import",
      "flight_no": "78E",
      "date": 1764172800,
      "updatetime": "1764412766",
      "importer_company_name": "UNIVERSAL CITY DEVELOPMENT PARTNERS",
      "exporter_company_name": "UNCAS HK CO LTD",
      "notify_party_name": "",
      "notify_address": "",
      "date_text": "2025-11-27",
      "exporterCountry": null,
      "importerCountry": null,
      "originCountry": null,
      "seller": {
        "snow_flake_id": "1039598798690041856",
Modified at 2026-07-16 18:33:00
Previous
(Customs) Country Reference
Next
Retrieve list of customs companies
Built with