Country of Origin
POST /api/v1/reportOrigCountry
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
int
Page number (min: 1, max: 1000)
- Example:
10
page_size
int
Page size (default: 10, max: 50)
- Example:
10
{
"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/reportOrigCountry \
-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/reportOrigCountry",
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/reportOrigCountry", {
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/reportOrigCountry");
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:
originCountry
string
Country of Origin
- Example:
United States of America
originCountryCode
string
ISO country code for Country of Origin
- Example:
US
totalSuppliers
int
Number of suppliers
- 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
{
"code": 200,
"success": true,
"data": [
{
"originCountry": "CHINA MAINLAND",
"originCountryCode": "CN",
"totalSuppliers": 842,
"totalQuantity": 100256577.71,
"totalWeight": 8484872.5,
"totalAmount": 92048671.28,
"transactionCount": 19380
}
],
"msg": "success",
"total": 2006,
"pageSize": 10,
"current": 1,
"sumResult": {
"totalAmount": 1592884532.19,
"totalQuantity": 294588523.02,
"totalWeight": 799452292.17,
"totalSuppliers": 2269,
"transactionCount": 78060
}
}
HS Code
Search and aggregate trade flows based on Harmonized System (HS) codes. Understand global demand, supply, and trade performance at the product level.
Country of Destination
Analyze which countries receive goods from specific exporters or regions. Useful for understanding export market penetration and demand patterns.