Company Basic Info API
Retrieve basic contact information for a company: name, address, phone, email and country.
ENDPOINTS
POST /api/v1/company/companyBasicInfo
Request parameters
com_role
integer
Company role in trade. 1 = buyer, 2 = supplier
- Required:
Yes - Example:
1
com_id
string
Company ID
- Required:
Yes - Example:
1ad397fa1acc309dae3dc54e4a963d4c
date
array<integer>
Date range. Two-element array of 8-digit integers [YYYYMMDD, YYYYMMDD]
- Required:
Yes - Example:
[20221211, 20231211]
Request Example
{
"com_role": 1,
"com_id": "1ad397fa1acc309dae3dc54e4a963d4c",
"date": [
20221211,
20231211
]
}
curl https://api.tradedata.io/api/v1/company/companyBasicInfo \
-H "Authorization: Bearer yourTokenHere" \
-H "Content-Type: application/json" \
-d '{"com_role": 1, "com_id": "1ad397fa1acc309dae3dc54e4a963d4c", "date": [20221211, 20231211]}'
import requests
response = requests.post(
"https://api.tradedata.io/api/v1/company/companyBasicInfo",
headers={
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
json={
"com_role": 1,
"com_id": "1ad397fa1acc309dae3dc54e4a963d4c",
"date": [
20221211,
20231211,
],
},
)
print(response.json())
const response = await fetch("https://api.tradedata.io/api/v1/company/companyBasicInfo", {
method: "POST",
headers: {
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
body: JSON.stringify({
"com_role": 1,
"com_id": "1ad397fa1acc309dae3dc54e4a963d4c",
"date": [
20221211,
20231211
]
}),
});
const data = await response.json();
<?php
$ch = curl_init("https://api.tradedata.io/api/v1/company/companyBasicInfo");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer yourTokenHere",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"com_role" => 1,
"com_id" => "1ad397fa1acc309dae3dc54e4a963d4c",
"date" => [
20221211,
20231211
]
]),
]);
echo curl_exec($ch);
Response parameters
data.uuid
string
Company unique identifier
- Example:
1ad397fa1acc309dae3dc54e4a963d4c
data.name
string
Company name
- Example:
Acme Corp
data.address
string
Company registered address
- Example:
123 Example Street, Example City
data.postal_code
array
Postal code list
data.city
array
City list
data.phone
array
Phone number list
- Example:
["+1 555-000-0000"]
data.email
array
Email address list
- Example:
["[email protected]"]
data.country
string
Country name
- Example:
Mainland China
data.iso3Code
string
Country ISO3 code
- Example:
CHN
Response Example
{
"code": 200,
"success": true,
"data": {
"uuid": "1ad397fa1acc309dae3dc54e4a963d4c",
"name": "Acme Corp",
"address": "123 Example Street, Example City",
"postal_code": null,
"city": null,
"phone": [
"+1 555-000-0000"
],
"email": [
"[email protected]"
],
"country": "Mainland China",
"iso3Code": "CHN"
},
"msg": "OK",
"total": 0,
"pageSize": 0,
"current": 0,
"sumResult": null
}
Company Filter List API
Retrieve available filter options (ports, countries, datasources) for a company's trade records. Use the same query parameters as companyDetail for consistent results, and call it once per query rather than on every page change.
Company Map Info API
Retrieve map data (coordinates, address, country) for a single company.