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 list of customs companies

POST
{{baseUrl}}/api/customs/companies/directory
Last modified:2026-07-16 18:33:08
Retrieve a list of customs companies.

Request

Header Params

Body Params application/json

Example
{
  "type": "exporter",
  "start_time": "2024-11-27",
  "end_time": "2025-11-27",
  "product": "pvc",
  "hscode": "",
  "tradeCode": "",
  "exporter_country": "140",
  "importer_country": "",
  "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/companies/directory' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "type": "exporter",
  "start_time": "2024-11-27",
  "end_time": "2025-11-27",
  "product": "pvc",
  "hscode": "",
  "tradeCode": "",
  "exporter_country": "140",
  "importer_country": "",
  "buyer": "",
  "seller": "",
  "departure_port": ""
}'

Responses

🟢201已创建
application/json
Bodyapplication/json

Example
{
  "success": true,
  "request_id": "req_4wk7gF4Ggvj",
  "data": {
    "code": 1,
    "msg": "Returned successfully",
    "time": "1776235107",
    "data": {
      "list": [
        {
          "country_name": "Mexico",
          "country_code": "mx",
          "total_amount": "111365.98",
          "trade_num": 765,
          "company_name": "MEXPIA SA DE CV",
          "raw_address": "",
          "id": "c3f60c46602b1e722723ad5adeb18aaa",
          "snow_flake_id": "c3f60c46602b1e722723ad5adeb18aaa",
          "product": "MODULO DE VISUALIZACION DISPLAY DE PANTALLA PLANA DE DIODOS EMISORES DE LUZ LED",
          "hs_code": "8524910100",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "910421433841635329",
          "date": 1760025600
        },
        {
          "country_name": "Peru",
          "country_code": "pe",
          "total_amount": "6727191.99",
          "trade_num": 621,
          "company_name": "SAMSUNG ELECTRONICS PERU SAC",
          "raw_address": "",
          "id": "ac5dbe61c0ac2be317016bde6e8c3cb3",
          "snow_flake_id": "ac5dbe61c0ac2be317016bde6e8c3cb3",
          "product": "MONITOR, SAMSUNG, LS27DG300ELXPE INTERFACE: HDMI, DISPLAY PORT POLICROMATICO,TAM. MON.: 27`` USO PRINCIPALMENTE CON COMPUTADORA LED, USO PRINCIPALMENTE CON COMPUTADORA / INTERFACE: HDMI, DISPLAY PORT",
          "hs_code": "8528520000",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "910121038708604928",
          "date": 1773244800
        },
        {
          "country_name": "United States",
          "country_code": "us",
          "total_amount": "7360.00",
          "trade_num": 387,
          "company_name": "ABSEN INC",
          "raw_address": "7120 lake ellenor drive, orlando, florida, united states",
          "id": "R2oidp0BRoKknSgQGUWP",
          "snow_flake_id": "R2oidp0BRoKknSgQGUWP",
          "product": "LED DISPLAY",
          "hs_code": "",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "910402770902888448",
          "date": 1775577600
        },
        {
          "country_name": "India",
          "country_code": "in",
          "total_amount": "762442.68",
          "trade_num": 312,
          "company_name": "RISHABH COMPONENT & CONNECTORS",
          "raw_address": "Mumbai, Maharashtra",
          "id": "4467a0b333e1bce81fb5f1eb33772604",
          "snow_flake_id": "4467a0b333e1bce81fb5f1eb33772604",
          "product": "LED DISPLAY. SP720401W/24/FZB (O/THAN REPUTED BRAND) LED DISPLAY.",
          "hs_code": "85319000",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1037791124461502464",
          "date": 1772726400
        },
        {
          "country_name": "United States",
          "country_code": "us",
          "total_amount": "18997.19",
          "trade_num": 308,
          "company_name": "LG ELECTRONICS ALABAMA INC",
          "raw_address": "Huntsville, Alabama",
          "id": "671506e8b9f13e6f3129f0a51bbfa95e",
          "snow_flake_id": "671506e8b9f13e6f3129f0a51bbfa95e",
          "product": "EBR24227303#&Bản mạch màn hình điều khiển của lò nướng 30inch, loại nút bấm, có tích hợp màn hình LED để hiển thị các chức năng, chế độ hoạt động của lò nướng-BCDIV(EBR24227303).Mới 100%#&VN,EBR24227303#&circuit boards-screen controls of the oven 30inch, type buttons, with integrated LED screen to display the function mode of operation of the oven-BCDIV(EBR24227303).New 100%#&VN",
          "hs_code": "85371013",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "910399821413781504",
          "date": 1763913600
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "138963.41",
          "trade_num": 243,
          "company_name": "CÔNG TY TNHH HANMIFLEXIBLE VINA HẢI PHÒNG",
          "raw_address": "",
          "id": "ef6ac843ddab2c64296f94c23002ee43",
          "snow_flake_id": "ef6ac843ddab2c64296f94c23002ee43",
          "product": "MHK65725505#&(MHK64887795)Tấm nhựa tự dính đã in, bằng nhựa polyester film, gắn phía trước bảng điều khiển, có các ô để hiển thị đèn LED, Mới 100%,MHK65725505#&(MHK64887795)plastic Sheet self adhesive printed vinyl, polyester film, attaching the front panel, there is the box to display the LED lights, 100% New",
          "hs_code": "39199099",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073653664787836928",
          "date": 1764172800
        },
        {
          "country_name": "Hong Kong, China",
          "country_code": "hk",
          "total_amount": "29036512.68",
          "trade_num": 231,
          "company_name": "HITRADE HONG KONG CO LIMITED",
          "raw_address": "",
          "id": "82e62f5f7ff4c451bd71a681dc91acb1",
          "snow_flake_id": "82e62f5f7ff4c451bd71a681dc91acb1",
          "product": "3TE50Q253403#&Tivi màn hình tinh thể lỏng LED TV 50 inch, hiệu Hisense (50 inch LED TV), model 50E7QTUK PRO. Hàng mới 100%#&VN,3TE50Q253403#&Tv, liquid crystal display, LED TV 50 inch, brand Hisense (50 inch LED TV), model 50E7QTUK PRO. New goods 100%#&VN",
          "hs_code": "85287292",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1091339529243750400",
          "date": 1767542400
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "881963.07",
          "trade_num": 226,
          "company_name": "CÔNG TY TNHH BAIKE VEHICLE VIỆT NAM",
          "raw_address": "",
          "id": "1d9645fcce13f9a0c8eaccba248665b5",
          "snow_flake_id": "1d9645fcce13f9a0c8eaccba248665b5",
          "product": "YGE1002007#&Màn hình LED màu, được gắn cố định trên xe dùng để hiển thị dữ liệu điều khiển trung tâm xe Golf điện 4 chỗ, vỏ bằng nhựa, 144W/2V/10A, KT (251*95*147)mm, mới 100%,YGE1002007#&LED Screen color is fixed on the car used to display data control center, Golf car, electric 4-seater, cover with plastic, 144W/2V/10A, KT (251*95*147)mm, 100% new",
          "hs_code": "85287292",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073659777332252672",
          "date": 1764172800
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "2296612.38",
          "trade_num": 204,
          "company_name": "CÔNG TY TNHH KORTEK VINA",
          "raw_address": "",
          "id": "9582bd456c33a5413cedbd299d3ea1d7",
          "snow_flake_id": "9582bd456c33a5413cedbd299d3ea1d7",
          "product": "Cụm dải đi ốt phát quang đã lắp ráp thành mảng module, lắp rắp trong tấp ốp nhựa, dùng cho sản xuất màn hình, mới 100%, Nhà sản xuất: Yaham, phụ tùng dùng cho màn hình LED , Hàng mẫu,Cluster strip emitting diode was assembled into the array module, assembled in drapery cladding, plastic, used for the production screen, 100% new, manufacturer: Yaham, spare parts for LED display , sample Order",
          "hs_code": "85414900",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073651474385301504",
          "date": 1764086400
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "182774.48",
          "trade_num": 185,
          "company_name": "CÔNG TY CỔ PHẦN HẠO PHƯƠNG",
          "raw_address": "",
          "id": "a1330e47d3585b266b0ccb80bb448bb5",
          "snow_flake_id": "a1330e47d3585b266b0ccb80bb448bb5",
          "product": "Board hiển thị dùng cho thang máy có màn hình LCD (LED), model: FJ7-HCBR602, NSX: SUZHOU INOVANCE TECHNOLOGY CO., LTD,, hàng mới 100%,Board display for elevator LCD (LED), model: FJ7-HCBR602, NSX: SUZHOU INOVANCE TECHNOLOGY CO., LTD., new goods 100%",
          "hs_code": "85312000",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073655902628503552",
          "date": 1764000000
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "24654.80",
          "trade_num": 147,
          "company_name": "CÔNG TY TNHH LEADER ELECTRIC APPLIANCE",
          "raw_address": "",
          "id": "19109501925597ab04dcb0de14c96ef9",
          "snow_flake_id": "19109501925597ab04dcb0de14c96ef9",
          "product": "2660090101#&HV300 LED light assy#đèn hiển thị (có nắp chụp bằng nhựa) HV300, gắn vào thân máy,(ko thuộc quyết định 1182/QĐ-BCT ngày 06/04/2021), mới 100%,2660090101#&HV300 LED light assy#lamp display (lid snap plastic) HV300, attached to the machine body(not belonging to decide 1182/QD-BCT dated 06/04/2021), new 100%",
          "hs_code": "85395290",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073646718173450240",
          "date": 1767542400
        },
        {
          "country_name": "United States",
          "country_code": "us",
          "total_amount": "0.00",
          "trade_num": 140,
          "company_name": "PLANAR SYSTEMS INC",
          "raw_address": "Lake Mills, WI",
          "id": "hF1AXJ0B_U_cuZYL7jma",
          "snow_flake_id": "hF1AXJ0B_U_cuZYL7jma",
          "product": "LED DISPLAY HTS:",
          "hs_code": "",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "910401037642092544",
          "date": 1775145600
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "2881285.16",
          "trade_num": 133,
          "company_name": "CÔNG TY TNHH LUMENS VINA",
          "raw_address": "",
          "id": "45290b03352165bf7891613754b06dfd",
          "snow_flake_id": "45290b03352165bf7891613754b06dfd",
          "product": "A1CGCECEBNP5P_Đi ốt phát sáng dùng để sản xuất đèn LED cho màn hình LED, điện áp sử dụng: 3.0-3.4VDC. Hàng mới 100%.,A1CGCECEBNP5P_Đi emitting diode light used to produce LEDS for LED display, voltage: 3.0-3.4 VDC. 100% brand new.",
          "hs_code": "85414100",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073648210579910656",
          "date": 1764172800
        },
        {
          "country_name": "Singapore",
          "country_code": "sg",
          "total_amount": "4907910.15",
          "trade_num": 131,
          "company_name": "HISENSE INTERNATIONAL ELECTRONICS TRADING SINGAPORE PTE LTD",
          "raw_address": "",
          "id": "9ad3daa9a3bd35341c628b6e06368c25",
          "snow_flake_id": "9ad3daa9a3bd35341c628b6e06368c25",
          "product": "3TE43G25420V#&Tivi màn hình tinh thể lỏng LED TV 43 inch, hiệu Hisense (43 inch LED TV), model 43E6Q. Hàng mới 100%#&VN,3TE43G25420V#&Tv, liquid crystal display, LED TV 43 inch, brand Hisense (43 inch LED TV), model 43E6Q. New goods 100%#&VN",
          "hs_code": "85287292",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1063423178241249280",
          "date": 1767542400
        },
        {
          "country_name": "India",
          "country_code": "in",
          "total_amount": "601739.08",
          "trade_num": 128,
          "company_name": "JABIL CIRCUIT INDIA PRIVATE LIMITED",
          "raw_address": "",
          "id": "19bccc90b69e82b75037184b3bb3dd00",
          "snow_flake_id": "19bccc90b69e82b75037184b3bb3dd00",
          "product": "V10024769 DISPLAY LED 1.44  W/RTP (APESCI TQA5144RHBM20T TRAY)V10024769 DISPLAY LED 1.44  W/RTP (APESCI TQA5144RHBM20T TRA",
          "hs_code": "85414100",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "910174979218505728",
          "date": 1772553600
        },
        {
          "country_name": "United States",
          "country_code": "us",
          "total_amount": "9874568.00",
          "trade_num": 127,
          "company_name": "ASCENT GLOBAL LOGISTICS",
          "raw_address": "2068 e street, belleville, michigan, united states",
          "id": "42b47782ccd34cc54dfdf6a1eaa8b9cb",
          "snow_flake_id": "42b47782ccd34cc54dfdf6a1eaa8b9cb",
          "product": "WOOD AND ARTICLES OF WOOD; WOOD CHARCOAL ; OTHER AND WOODEN DECORATION(DESKTOP ORNAMENT,S HADOWBOX,ETC) WOODEN DECORATION(WOOD VASE) STICKER HAIR TIE BEAD KIT ROUND BEAD NECKLACE CHARM SKILLFFFUBGD-PIAB FOIL FUN SKILL FFPABGD-PIAB FOIL FUN SKILLPIAFGD-PIA B POKE IN ART ACTUAL SHIPPER: GRASPER GLOBAL INC C/O WENZHOU CREATE FUN CRAFT FUTURE HORI ZON ART AND CRAFT CO., LIMITED ZHEJIANG HONGYE ART & CRAFT CO., LTD. PO NO.: CHA RMS DISPLAYER CRAFTING KITS AGES + DISPLAYER DIY KIDS CRAFTING KITS DISPLAYER IRON JEWELR Y DISPLAYER JEWELRY CRAFTING KITS DISPLAYER PLASTIC BEADS DISPLAYER PLASTIC BEADS AND PLASTIC BEAD KIT FOR AGES + DISPLAYER PLASTIC H AIR TIES DISPLAYER PO NO.: CARD GAME AGES DISPLAYER PAPER FOIL ACTIVITY SHEETS AGES DISPLAYER POKE IN ART ACTIVITY KITS A GES DISPLAYER PO NO.: PRINTED VIN YL STICKERS DISPLAYER PO NO.: PLYWOO D DECOR DISPLAYER PLYWOOD FIGURINES DISPLAYERPLYWOOD LED DECOR DISPLAYER PLYWOOD LED SHAD OWBOX DISPLAYER PLYWOOD PLAQUE DISPLAYER PLYW OOD SHADOWBOX DISPLA",
          "hs_code": "852990",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "910399430411710464",
          "date": 1772812800
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "1567948.59",
          "trade_num": 127,
          "company_name": "CÔNG TY TNHH INZI VINA",
          "raw_address": "",
          "id": "cdb4c14e1fe3aaf60d25e7633d0d6899",
          "snow_flake_id": "cdb4c14e1fe3aaf60d25e7633d0d6899",
          "product": "T01G-137898001#&LÕI THÉP KHUÔN ÉP NHỰA MIẾNG GIỮ LED PCB MÀN HÌNH HIỂN THỊ / INSERT CORE OF HOLDER-LED PCB USED FOR MOLD NO BN61-20235A001, 1 SET = 16 PCE. MỚI 100%,T01G-137898001#&PLASTIC INJECTION MOLD STEEL CORE LED PCB HOLDER DISPLAY / INSERT CORE OF HOLDER-LED PCB USED FOR MOLD NO. BN61-20235A001, 1 SET = 16 PCE. 100% NEW",
          "hs_code": "73269099",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073653701798428672",
          "date": 1764259200
        },
        {
          "country_name": "Vietnam",
          "country_code": "vn",
          "total_amount": "1738458.80",
          "trade_num": 123,
          "company_name": "CÔNG TY TNHH GENBYTE TECHNOLOGY VIỆT NAM",
          "raw_address": "",
          "id": "d1f3b7be0158e122573a6ca25f770a3c",
          "snow_flake_id": "d1f3b7be0158e122573a6ca25f770a3c",
          "product": "Bảng hiển thị-Đi-ốt phát quang (LED),dùng sx bảng mạch,thiết bị điện tử,hiệu:SHINE,spec:JXSNW30145B07DY,mới 100%,Table display-Go-emitting diode (LED),used for manufacturing circuit board,electronic device,effect:SHINE,spec:JXSNW30145B07DY,100% new",
          "hs_code": "85312000",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1073646748796198912",
          "date": 1767542400
        },
        {
          "country_name": "South Korea",
          "country_code": "kr",
          "total_amount": "2725419.63",
          "trade_num": 122,
          "company_name": "KORTEK CORPORATION",
          "raw_address": "",
          "id": "8eee2ad8517de913392e6265cb0d4289",
          "snow_flake_id": "8eee2ad8517de913392e6265cb0d4289",
          "product": "502459#&Màn hình hiển thị hình ảnh 55 inch cong dùng cho máy chơi game, có chức năng cảm ứng, có LED, loại màu, model KTC550DPZ03, đ.áp 24V, d.điện 3.7A và đ.áp 24V, d.điện 3.3A DGGC:64.86$/PCE#&VN,502459#&display pictures 55 inch curved for game machine, has the function of induction, LED, type, color model KTC550DPZ03 was.voltage 24V d.power 3.7 A and have.voltage 24V d.power 3.3 A DGGC:64.86$/PCE#&VN",
          "hs_code": "85285910",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1039651015879520256",
          "date": 1767542400
        },
        {
          "country_name": "United States",
          "country_code": "us",
          "total_amount": "0.00",
          "trade_num": 121,
          "company_name": "SANSI NORTH AMERICA LLC",
          "raw_address": "New York, New York",
          "id": "p28kdp0BP04AR2t9dG5B",
          "snow_flake_id": "p28kdp0BP04AR2t9dG5B",
          "product": "LED DISPLAY LED MODULE CONTROL BOARD CONVERSION CARD POWER SUPPLY CONTROLLER PLASTIC MASK MAINTENANCE TOOL KIT CP",
          "hs_code": "",
          "hs_product": "",
          "is_collect": false,
          "importer_id": "1039977426739081216",
          "date": 1775577600
        }
      ],
      "current_page": 1,
      "last_page": 238,
      "total": 4748
    }
  },
  "meta": {
    "billing": {
      "credits_charged": 2.72,
      "byok_used": false
    }
  },
  "error": null
}
Modified at 2026-07-16 18:33:08
Previous
Retrieve customs data list
Next
Retrieve a company's customs status
Built with