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 global customs regional distribution map

POST
{{baseUrl}}/api/customs/analytics/world-regions
Last modified:2026-07-16 18:34:03
Retrieve the global regional distribution map of customs.

Request

Header Params

Body Params application/json

Example
{
  "type": "exporter",
  "start_time": "2024-04-19",
  "end_time": "2025-04-18",
  "product": "pet",
  "hscode": "",
  "tradeCode": "",
  "buyer": "",
  "seller": "",
  "departure_port": ""
}

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/analytics/world-regions' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "type": "exporter",
  "start_time": "2024-04-19",
  "end_time": "2025-04-18",
  "product": "pet",
  "hscode": "",
  "tradeCode": "",
  "buyer": "",
  "seller": "",
  "departure_port": ""
}'

Responses

🟢201已创建
application/json
Bodyapplication/json

Example
{
  "success": true,
  "request_id": "req_nQoYWnuIjKOv",
  "data": {
    "code": 1,
    "msg": "Success: Retrieval successful",
    "time": "1776239021",
    "data": {
      "total": 169,
      "list": [
        {
          "exporter_country_id": 140,
          "amount": "0.00",
          "qty": "3556751220",
          "tradeCount": 675879,
          "sellerCount": 26662,
          "sellerCountryId": null,
          "buyerCount": 115601,
          "buyerCountryId": null,
          "name": "China",
          "icon": "http://ai.keep1.net/uploads/country/cn.png",
          "weight": "4860572861.748",
          "tradePercent": 53.09,
          "en": "China"
        },
        {
          "exporter_country_id": 41,
          "amount": "0.00",
          "qty": "2201211551",
          "tradeCount": 175179,
          "sellerCount": 4535,
          "sellerCountryId": null,
          "buyerCount": 5541,
          "buyerCountryId": null,
          "name": "Vietnam",
          "icon": "http://ai.keep1.net/uploads/country/vn.png",
          "weight": "780717650.895",
          "tradePercent": 13.76,
          "en": "Vietnam"
        },
        {
          "exporter_country_id": 167,
          "amount": "0.00",
          "qty": "686306424",
          "tradeCount": 56444,
          "sellerCount": 3918,
          "sellerCountryId": null,
          "buyerCount": 6193,
          "buyerCountryId": null,
          "name": "India",
          "icon": "http://ai.keep1.net/uploads/country/in.png",
          "weight": "417887447.752",
          "tradePercent": 4.43,
          "en": "India"
        },
        {
          "exporter_country_id": 226,
          "amount": "0.00",
          "qty": "285385946",
          "tradeCount": 35276,
          "sellerCount": 896,
          "sellerCountryId": null,
          "buyerCount": 1263,
          "buyerCountryId": null,
          "name": "Thailand",
          "icon": "http://ai.keep1.net/uploads/country/th.png",
          "weight": "608745383.393",
          "tradePercent": 2.77,
          "en": "Thailand"
        },
        {
          "exporter_country_id": 72,
          "amount": "0.00",
          "qty": "379517007",
          "tradeCount": 31679,
          "sellerCount": 2277,
          "sellerCountryId": null,
          "buyerCount": 2315,
          "buyerCountryId": null,
          "name": "Hong Kong, China",
          "icon": "http://ai.keep1.net/uploads/country/hk.png",
          "weight": "957153264.935",
          "tradePercent": 2.49,
          "en": null
        },
        {
          "exporter_country_id": 25,
          "amount": "0.00",
          "qty": "280725343",
          "tradeCount": 28505,
          "sellerCount": 1523,
          "sellerCountryId": null,
          "buyerCount": 1883,
          "buyerCountryId": null,
          "name": "South Korea",
          "icon": "http://ai.keep1.net/uploads/country/kr.png",
          "weight": "226629714.379",
          "tradePercent": 2.24,
          "en": "Korea"
        },
        {
          "exporter_country_id": 75,
          "amount": "0.00",
          "qty": "255293179",
          "tradeCount": 26412,
          "sellerCount": 2451,
          "sellerCountryId": null,
          "buyerCount": 1921,
          "buyerCountryId": null,
          "name": "United States",
          "icon": "http://ai.keep1.net/uploads/country/us.png",
          "weight": "521278455.232",
          "tradePercent": 2.07,
          "en": "the United States"
        },
        {
          "exporter_country_id": 119,
          "amount": "0.00",
          "qty": "88762393",
          "tradeCount": 16789,
          "sellerCount": 1010,
          "sellerCountryId": null,
          "buyerCount": 1294,
          "buyerCountryId": null,
          "name": "Taiwan, China",
          "icon": "http://ai.keep1.net/uploads/country/tw.png",
          "weight": "2396696854.453",
          "tradePercent": 1.32,
          "en": null
        },
        {
          "exporter_country_id": 112,
          "amount": "0.00",
          "qty": "851661710",
          "tradeCount": 14446,
          "sellerCount": 1947,
          "sellerCountryId": null,
          "buyerCount": 3840,
          "buyerCountryId": null,
          "name": "Turkey",
          "icon": "http://ai.keep1.net/uploads/country/tr.png",
          "weight": "229417482.468",
          "tradePercent": 1.13,
          "en": "Turkey"
        },
        {
          "exporter_country_id": 107,
          "amount": "0.00",
          "qty": "109176114",
          "tradeCount": 13620,
          "sellerCount": 417,
          "sellerCountryId": null,
          "buyerCount": 1397,
          "buyerCountryId": null,
          "name": "Indonesia",
          "icon": "http://ai.keep1.net/uploads/country/id.png",
          "weight": "260705934.880",
          "tradePercent": 1.07,
          "en": "Indonesia"
        }
      ],
      "qty": "20696865559",
      "tradeCount": 1273129
    }
  },
  "meta": {
    "billing": {
      "credits_charged": 0.14,
      "byok_used": false
    }
  },
  "error": null
}
Modified at 2026-07-16 18:34:03
Previous
Retrieve customs procurement trends
Next
Retrieve customs transactions for Chinese suppliers
Built with