Business Contact Company Snippet API
Retrieve lightweight company profile data for multiple organizations by ID.
ENDPOINTS
POST /api/v1/businessContact/company/snippet
Request parameters
ids
array
List of organization IDs to query.
- Required:
Yes - Example:
["5b1b2c3d4e5f000000000001", "5b1b2c3d4e5f000000000002"]
Request Example
{
"ids": [
"5b1b2c3d4e5f000000000001",
"5b1b2c3d4e5f000000000002"
]
}
curl https://api.tradedata.io/api/v1/businessContact/company/snippet \
-H "Authorization: Bearer yourTokenHere" \
-H "Content-Type: application/json" \
-d '{"ids": ["5b1b2c3d4e5f000000000001", "5b1b2c3d4e5f000000000002"]}'
import requests
response = requests.post(
"https://api.tradedata.io/api/v1/businessContact/company/snippet",
headers={
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
json={
"ids": [
"5b1b2c3d4e5f000000000001",
"5b1b2c3d4e5f000000000002",
],
},
)
print(response.json())
const response = await fetch("https://api.tradedata.io/api/v1/businessContact/company/snippet", {
method: "POST",
headers: {
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
body: JSON.stringify({
"ids": [
"5b1b2c3d4e5f000000000001",
"5b1b2c3d4e5f000000000002"
]
}),
});
const data = await response.json();
<?php
$ch = curl_init("https://api.tradedata.io/api/v1/businessContact/company/snippet");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer yourTokenHere",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"ids" => [
"5b1b2c3d4e5f000000000001",
"5b1b2c3d4e5f000000000002"
]
]),
]);
echo curl_exec($ch);
Response parameters
data
array
List of company snippet objects.
data.id
string
Organization ID.
- Example:
5b1b2c3d4e5f000000000001
data.industry
string
Primary industry.
- Example:
logistics & supply chain
data.industries
array
Industry list.
data.keywords
array
Company keyword tags.
data.estimated_num_employees
integer
Estimated employee count.
- Example:
3500
data.organization_revenue
number
Annual revenue (USD).
- Example:
39958000
data.organization_revenue_printed
string
Formatted revenue label.
- Example:
40.0M
data.website_url
string
Company website URL.
- Example:
http://www.example.com
data.domain
string
Primary domain.
- Example:
example.com
data.country
string
Country.
- Example:
Hong Kong
data.city
string
City.
- Example:
Hong Kong
data.state
string
State or region.
- Example:
Kowloon
data.street_address
string
Street address.
- Example:
123 Example Street
data.postal_code
string
Postal code.
data.raw_address
string
Full raw address string.
- Example:
123 example street, kowloon, hk
data.linkedin_url
string
LinkedIn company page URL.
- Example:
https://www.linkedin.com/company/example-corp
data.logo_url
string
Company logo image URL.
- Example:
https://example.com/logo.png
data.snippets_loaded
boolean
Whether full snippet data was loaded.
- Example:
true
data.retail_location_count
integer
Number of retail locations.
- Example:
0
Response Example
{
"code": 200,
"success": true,
"data": [
{
"id": "5b1b2c3d4e5f000000000001",
"industry": "logistics & supply chain",
"industries": [
"logistics & supply chain"
],
"keywords": [
"transportation, logistics, supply chain & storage"
],
"estimated_num_employees": 3500,
"organization_revenue": 39958000,
"organization_revenue_printed": "40.0M",
"website_url": "http://www.example.com",
"domain": "example.com",
"country": "Hong Kong",
"city": "Hong Kong",
"state": "Kowloon",
"street_address": "123 Example Street",
"postal_code": null,
"raw_address": "123 example street, kowloon, hk",
"linkedin_url": "https://www.linkedin.com/company/example-corp",
"logo_url": "https://example.com/logo.png",
"snippets_loaded": true,
"retail_location_count": 0
}
],
"msg": "OK",
"total": 0,
"pageSize": 0,
"current": 0,
"sumResult": null
}