获取海关数据列表 - TradeWind AI API 2.0 Documentation

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

curl --location 'https://app.trade-wind.co/api/customs/search' \
--header 'Authorization: Bearer tw_live_9d991654520ba5bb1b100db5d0d0f62193b887436cb20e4a35b217312ed18626' \
--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": "正常"
            },
            "origin_country": null,
            "importer_country": {
                "id": 75,
                "name": "美国",
                "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": "正常"
            },
            "exporter_country": {
                "id": 140,
                "name": "中国",
                "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": "正常"
            },
            "seller_name": null,
            "buyer_name": "WALGREEN CO",
            "origin_country_name": null,
            "importer_country_name": "美国",
            "exporter_country_name": "中国",
            "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",