Business Contact Company Page API
Paginated search for companies in the business contact database.
ENDPOINTS
POST /api/v1/businessContact/company/page
Request parameters
orgName
string
Company name keyword
- Required:
No - Example:
apple
locations
array
Country filter list
- Required:
No - Example:
["China", "United States"]
industryIds
array
Industry ID filter. Get valid IDs from /businessContact/industry
- Required:
No - Example:
["5d1b2c3d4e5f000000000001"]
employeesRanges
array
Employee count range filter. Get valid ranges from /businessContact/staff
- Required:
No - Example:
["21,50"]
revenueMin
string
Minimum annual revenue filter
- Required:
No - Example:
500000
revenueMax
string
Maximum annual revenue filter
- Required:
No - Example:
600000
orgIds
array
Specific company IDs to look up
- Required:
No - Example:
[]
current
integer
Page number (default: 1)
- Required:
No - Example:
1
size
integer
Page size (max: 25)
- Required:
No - Example:
25
Request Example
{
"orgName": "apple",
"locations": [
"China",
"United States"
],
"industryIds": [
"5d1b2c3d4e5f000000000001"
],
"revenueMin": "500000",
"revenueMax": "600000",
"employeesRanges": [
"21,50"
],
"current": 1,
"size": 25
}
curl https://api.tradedata.io/api/v1/businessContact/company/page \
-H "Authorization: Bearer yourTokenHere" \
-H "Content-Type: application/json" \
-d '{"orgName": "apple", "locations": ["China", "United States"], "industryIds": ["5d1b2c3d4e5f000000000001"], "revenueMin": "500000", "revenueMax": "600000", "employeesRanges": ["21,50"], "current": 1, "size": 25}'
import requests
response = requests.post(
"https://api.tradedata.io/api/v1/businessContact/company/page",
headers={
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
json={
"orgName": "apple",
"locations": [
"China",
"United States",
],
"industryIds": [
"5d1b2c3d4e5f000000000001",
],
"revenueMin": "500000",
"revenueMax": "600000",
"employeesRanges": [
"21,50",
],
"current": 1,
"size": 25,
},
)
print(response.json())
const response = await fetch("https://api.tradedata.io/api/v1/businessContact/company/page", {
method: "POST",
headers: {
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
body: JSON.stringify({
"orgName": "apple",
"locations": [
"China",
"United States"
],
"industryIds": [
"5d1b2c3d4e5f000000000001"
],
"revenueMin": "500000",
"revenueMax": "600000",
"employeesRanges": [
"21,50"
],
"current": 1,
"size": 25
}),
});
const data = await response.json();
<?php
$ch = curl_init("https://api.tradedata.io/api/v1/businessContact/company/page");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer yourTokenHere",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"orgName" => "apple",
"locations" => [
"China",
"United States"
],
"industryIds" => [
"5d1b2c3d4e5f000000000001"
],
"revenueMin" => "500000",
"revenueMax" => "600000",
"employeesRanges" => [
"21,50"
],
"current" => 1,
"size" => 25
]),
]);
echo curl_exec($ch);
Response parameters
data
array
List of matching companies
data.id
string
Record ID
- Example:
66285b16...
data.orgId
string
Organization ID
- Example:
5fcd2cf3...
data.name
string
Company name
- Example:
Apple
data.country
string
Country name
- Example:
United States
data.iso3Code
string
ISO 3166-1 alpha-3 country code
- Example:
USA
data.city
string
City
- Example:
Cupertino
data.state
string
State/Province
- Example:
California
data.domain
string
Primary domain
- Example:
apple.com
data.website
string
Website URL
- Example:
http://www.apple.com
data.employeesNum
integer
Employee count
- Example:
164000
data.industry
string
Industry
- Example:
electrical/electronic manufacturing
data.foundedYear
string
Year founded
- Example:
1976
data.marketCap
string
Market capitalization
- Example:
4308.1B
data.annualRevenue
number
Annual revenue
data.logoUrl
string
Company logo URL
- Example:
https://...
data.linkedinUrl
string
LinkedIn URL
- Example:
http://www.linkedin.com/...
data.twitterUrl
string
Twitter URL
- Example:
https://twitter.com/...
data.primaryPhone
string
Primary phone (JSON object)
- Example:
{...}
data.shortDescription
string
Short description
total
integer
Total matching records
- Example:
2607
pageSize
integer
Total pages
- Example:
261
current
integer
Current page
- Example:
0
Response Example
{
"code": 200,
"success": true,
"data": [
{
"id": "5c1b2c3d4e5f000000000001",
"accountCode": null,
"websiteUrl": "http://www.apple.com",
"estimatedNumEmployees": 164000,
"rawAddress": "123 Example Street, Example City, State 00000, US",
"orgId": "5b1b2c3d4e5f000000000001",
"organizationId": "5b1b2c3d4e5f000000000001",
"name": "Apple",
"highLight": "<em>Apple</em>",
"website": "http://www.apple.com",
"blogUrl": null,
"angellistUrl": null,
"linkedinUrl": "https://www.linkedin.com/company/example-corp",
"twitterUrl": "https://twitter.com/apple",
"facebookUrl": "https://facebook.com/apple/",
"primaryPhone": "{\"number\":\"+1 555-000-0000\",\"sanitized_number\":\"+15550000000\",\"source\":\"Owler\"}",
"shortDescription": "",
"annualRevenue": null,
"annualRevenuePrinted": null,
"employeesNum": 164000,
"industry": "electrical/electronic manufacturing",
"industryId": null,
"foundedYear": "1976",
"keywords": [
"retail"
],
"publiclyTradedSymbol": "AAPL",
"publiclyTradedExchange": "nasdaq",
"marketCap": "4308.1B",
"latestFundingRoundDate": null,
"latestFundingStage": null,
"technologies": null,
"country": "United States",
"iso3Code": "USA",
"address": "123 Example Street, Example City, State 00000, US",
"street": null,
"city": "Cupertino",
"state": "California",
"postalCode": "00000",
"domain": "apple.com",
"primaryDomain": "apple.com",
"logoUrl": "https://example.com/logo.png"
}
],
"msg": "OK",
"total": 2607,
"pageSize": 261,
"current": 0,
"sumResult": null
}