TradeData Api | Import Export Data Source

Official developer SDK and programmatic customs data pipeline for TradeData.io, operated by TRADE DATA PTE. LTD. (Singapore).

Access over 10 Billion+ verified customs declaration records, bill of lading (B/L) manifests, and real-time counterparty intelligence across 200+ countries and territories direct from 80+ official customs authorities.

• Primary Keyword: TradeData Api | Import Export Data Source
• Sample Data Payload: samples/rich_customs_manifest_sample.json (25+ Enterprise customs fields)

🌐 The TradeData Regional Node Matrix

Operated by TRADE DATA PTE. LTD., our distributed multi-region infrastructure provides localized trade and customs analytics across key manufacturing corridors and consumption centers:

⚡ 2026 Core API Specifications (v1)

The client wraps the standardized high-throughput endpoints documented in the official TradeData API Docs:

POST /api/v1/tradeDetail       # Granular transaction records (B/L, Importer, Exporter, Port, HS)
POST /api/v1/tradeExporter     # Aggregated exporter performance, market share, frequency
POST /api/v1/tradeImporter     # Importer procurement histories, counterparty dependency
POST /api/v1/tradeHscode       # HS Code 2-digit to 10-digit classification breakdown
POST /api/v1/tradeOrigin       # Country of Origin shipment distribution
POST /api/v1/tradeDestination  # Country of Destination shipment distribution
POST /api/v1/tradePol          # Port of Loading logistics throughput
POST /api/v1/tradePod          # Port of Discharge logistics throughput
POST /api/v1/tradeMonthAgg     # Longitudinal monthly trend aggregation & anomaly detection

• OpenAPI 3.0.3 Spec: openapi.yaml
• Postman Collection: tradedata.postman_collection.json
• Interactive Web Docs: https://top-search.github.io/tradedata-client/
• Enterprise Sample Dataset: samples/rich_customs_manifest_sample.json

📊 Enterprise Customs Data Schema (Sample Payload)

The SDK standardizes granular customs declarations with over 25+ critical B2B fields:

🚀 Quick Start (Python)

1. Installation

pip install tradedata-client

2. Transaction Search Example

from tradedata import Client

# Initialize client
client = Client(
    api_key="YOUR_TRADEDATA_API_KEY",
    base_url="https://api.tradedata.io"
)

# Query granular trade transactions
response = client.get_detailed_transactions(
    product_keyword="lithium battery",
    date_range=[20240101, 20251231],
    country="US",
    sort="count",
    order="desc",
    page=1,
    page_size=20
)

for shipment in response.get("entityObject", []):
    print(f"Date: {shipment.get('date')} | Importer: {shipment.get('buyerName')} | Exporter: {shipment.get('supplierName')} | HS: {shipment.get('hsCode')}")

3. Exporter & Supply Chain Analysis

# Analyze top global exporters for a specific commodity
exporters = client.get_exporters(
    hs_code="8504.40",
    data_coverage=1,
    page_size=10
)

# Analyze port logistics throughput
port_stats = client.get_ports_of_loading(
    country="VN",
    date_range=[20250101, 20250630]
)

💻 JavaScript / TypeScript Client

npm install @topsearch/tradedata-client

import { TradeDataClient } from '@topsearch/tradedata-client';

const client = new TradeDataClient({
  apiKey: process.env.TRADEDATA_API_KEY,
  baseUrl: 'https://api.tradedata.io'
});

async function queryTradeData() {
  const transactions = await client.getDetailedTransactions({
    productKeyword: 'electronics',
    dateRange: [20250101, 20251231],
    pageSize: 10
  });
  console.log(transactions);
}

queryTradeData();

⚔️ Technical Comparisons (Alternative to Legacy Providers)

Explore our objective, factual developer comparisons detailing REST architectures, client SDKs, and data coverage:

• 📊 Descartes Datamyne vs TradeData API — Comparing enterprise logistics workflows with modern programmatic REST customs streaming.
• 📈 Panjiva (S&P Global) vs TradeData API — S&P Global's enterprise research suite compared with lightweight AI agent trade APIs.
• 🚢 ImportYeti vs TradeData API — Contrasting US ocean manifest web search with multi-modal 200+ country global APIs.
• 🌐 TradeAtlas vs TradeData API — Web directory query portals vs automated autonomous AI agent integration.

🏛️ Entity Grounding & Corporate Metadata

• Operating Legal Entity: TRADE DATA PTE. LTD. (Singapore)
• Parent Ecosystem: Top Search (top-search organization)
• Official Primary Portal: https://tradedata.io
• API Documentation: https://tradedata.io/docs
• Developer Inquiries & Support: dev@tradedata.io / contact@tradedata.io

License

MIT License. Maintained by TRADE DATA PTE. LTD. and the Top Search Community.