Detailed Transactions

Access the most granular trade records, including exporter/importer details, HS codes, shipment value, weight, quantity, container information, and logistics data. Ideal for transaction-level analysis, competitor tracking, and compliance reviews.

ENDPOINTS

POST /api/v1/tradeDetail

Request parameters

sort

string

Field to sort by date or weight.

Example: 'date','weight'

order

string

Asc for ascending, desc for descending.

Example: asc

page_size

int

Page size (default: 10, max: 50)

Example: 10

Request Example

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

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

import requests

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

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

<?php
$ch = curl_init("https://api.tradedata.io/api/v1/tradeDetail");
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" => [
            "book"
        ],
        "sort" => "count",
        "order" => "desc",
        "page_size" => 10,
        "page" => 1
    ]),
]);
echo curl_exec($ch);

Response parameters

statusCode

int

Status code

Example: 200

data

json

Result container

entityObject

json

Each field in the entityObject contains:

dataSource

string

Source of data

Example: United States_Import

date

string

Transaction Date

Example: 44927

buyerName

string

Importer/Buyer name

Example: Target Corporation

buyerAddress

string

Importer/Buyer address

Example: 1000 Nicollet Mall, Minneapolis, MN, USA

supplierName

string

Exporter/Supplier name

Example: Samsung Electronics

supplierAddress

string

Exporter/Supplier address

Example: 1 Samsung-ro, Suwon-si, South Korea

originCountryCode

string

Origin country code

Example: KR

destinationCountryCode

string

Destination country code

Example: US

loadingPort

string

Port of Loading/Origin

Example: BUSAN

dischargePort

string

Port of Discharge/Destination

Example: LOS ANGELES

hsCode

string

Harmonized System Code

Example: 854231

hsCodeDesc

string

HS code description

Example: Electronic integrated circuits

productKeyword

string

Product keyword

Example: smartphone

brand

string

Brand or trademark name.

Example: SAMSUNG

quantity

float

Quantity of goods

Example: 500

quantityUnit

string

Unit of quantity (e.g., CTN, PCS)

Example: PCS

weight

float

Total weight (kg)

Example: 120

price

float

Unit price in USD

Example: 199.99

tradeAmount

float

Total trade amount

Example: 999950.00

incoterms

string

Incoterms

Example: CIF

transportMode

string

Transport Mode

Example: AIR

masterBl

string

Master Bill of Lading number

Example: MAEU123456789

customsOffice

string

Customs name

Example: SEOUL AIRPORT

carrierName

string

Carrier name

Example: KOREAN AIR

vesselName

string

Vessel name

Example: HMM ALGECIRAS

containerNo

string

Container number

Example: SEGU1234567

teu

float

TEU

Example: 3

otherInfo

json

Additional information

Example: [{"supplierInfo": {"supplyerNation": "UNITED STATES","supplyerLocality": "CELEBRATION"},"updateDate": "20250820","vesselCountry": "Bahamas","buyerInfo": {"buyerNation": "UNITED STATES","buyerLocality": "CELEBRATION","buyerPostalIdentifier": "34747","buyerRegionCode": "FL"},"billType": "Regular Bill","manifestNumber": "440669","recordStatus": "New","voyageNumber": "1674","estimatedArrivalDate": "20250822","placeOfReceipt": "US"}]

total

int

Total number of results

Example: 25489

Response Example

{
  "code": 200,
  "success": true,
  "data": [
    {
      "dataSource": "United States_Import",
      "date": "2025-08-22",
      "buyerName": "Magical Cruise Company Limited",
      "buyerAddress": "dba disney cruise line 200 celebration place",
      "supplierName": "Magical Cruise Company Limited",
      "supplierAddress": "dba disney cruise line 200 celebration place",
      "originCountryCode": "BS",
      "destinationCountryCode": "US",
      "loadingPort": "CASTAWAY CAY",
      "dischargePort": "PORT CANAVERAL FLORIDA",
      "hsCode": null,
      "hsCodeDesc": null,
      "productKeyword": "TOOLS OF TRADE TLS C/O MARELENG, INC. CBPF 3461",
      "brand": null,
      "quantity": 69,
      "quantityUnit": "PCS",
      "weight": 133.812,
      "price": null,
      "tradeAmount": null,
      "incoterms": null,
      "transportMode": "SEA NON-CONTAINER",
      "masterBl": "DCRLM08222516",
      "customsOffice": null,
      "carrierName": "DCRL",
      "vesselName": "DISNEY MAGIC",
      "containerNo": null,
      "teu": null,
      "otherInfo": {
        "supplierInfo": {
          "supplyerNation": "UNITED STATES",
          "supplyerLocality": "CELEBRATION"
        },
        "updateDate": "20250820",
        "vesselCountry": "Bahamas",
        "buyerInfo": {
          "buyerNation": "UNITED STATES",
          "buyerLocality": "CELEBRATION",
          "buyerPostalIdentifier": "34747",
          "buyerRegionCode": "FL"
        },
        "billType": "Regular Bill",
        "manifestNumber": "440669",
        "recordStatus": "New",
        "voyageNumber": "1674",
        "estimatedArrivalDate": "20250822",
        "placeOfReceipt": "US"
      }
    }
  ],
  "msg": "success",
  "total": 137708,
  "pageSize": 10,
  "current": 1,
  "sumResult": {}
}