Exporter

Analyze export activities by company. Identify top exporters, aggregated shipment frequency, value, weight, and quantity. Useful for supplier sourcing and trade route intelligence.

ENDPOINTS

POST /api/v1/reportSearchSuppliers

Request parameters

sort

string

Field to sort by date or weight.

Example: 'count','weight','amount'

order

string

Asc for ascending, desc for descending.

Example: desc

page_size

int

Page size (default: 10, max: 50)

Example: 10

Request Example

{
  "data_coverage": 1,
  "date_range": [20220101, 20220130],
  "product_keyword": ["led"],
  "sort": "count",
  "order": "desc",
  "page_size": 10,
  "page": 1
}

curl https://api.tradedata.io/api/v1/reportSearchSuppliers \
  -H "Authorization: Bearer yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{"data_coverage": 1, "date_range": [20220101, 20220130], "product_keyword": ["led"], "sort": "count", "order": "desc", "page_size": 10, "page": 1}'

import requests

response = requests.post(
    "https://api.tradedata.io/api/v1/reportSearchSuppliers",
    headers={
        "Authorization": "Bearer yourTokenHere",
        "Content-Type": "application/json",
    },
    json={
        "data_coverage": 1,
        "date_range": [
            20220101,
            20220130,
        ],
        "product_keyword": [
            "led",
        ],
        "sort": "count",
        "order": "desc",
        "page_size": 10,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.tradedata.io/api/v1/reportSearchSuppliers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer yourTokenHere",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "data_coverage": 1,
    "date_range": [
      20220101,
      20220130
    ],
    "product_keyword": [
      "led"
    ],
    "sort": "count",
    "order": "desc",
    "page_size": 10,
    "page": 1
  }),
});
const data = await response.json();

<?php
$ch = curl_init("https://api.tradedata.io/api/v1/reportSearchSuppliers");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer yourTokenHere",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "data_coverage" => 1,
        "date_range" => [
            20220101,
            20220130
        ],
        "product_keyword" => [
            "led"
        ],
        "sort" => "count",
        "order" => "desc",
        "page_size" => 10,
        "page" => 1
    ]),
]);
echo curl_exec($ch);

Response parameters

statusCode

int

Status code

Example: 200

data

array

Result container

entityObject

Json

Each field in the entityObject contains:

supplierName

string

Supplier name

Example: Samsung Electronics

totalBuyers

int

Number of buyers

Example: 133

totalQuantity

float

Total quantity of goods (aggregated)

Example: 212.89

totalWeight

float

Total shipment weight (aggregated, kg)

Example: 342.72

totalAmount

float

Total trade amount (aggregated,USD)

Example: 523.72

transactionCount

int

Total number of trade records or shipments

Example: 352

total

int

Total number of grouped records returned in this result set

Example: 2006

Response Example

{
  "code": 200,
  "success": true,
  "data": [
    {
      "supplierName": "TCL OVERSEAS MARKETING LTD",
      "totalBuyers": 19,
      "totalQuantity": 100256577.71,
      "totalWeight": 8484872.5,
      "totalAmount": 92048671.28,
      "transactionCount": 19380
    }
  ],
  "msg": "success",
  "total": 2006,
  "pageSize": 10,
  "current": 1,
  "sumResult": {}
}

Business Info API

Search company registration information by name (currently supports Vietnam only).

Importer

Analyze import activities by company. Identify top importers, aggregated shipment frequency, value, weight, and quantity. Useful for supplier sourcing and trade route intelligence.