Business Contact Fuzzy Search API
Fuzzy search for companies and people by keyword.
ENDPOINTS
POST /api/v1/businessContact/fuzzy
Request parameters
query
string
Search keyword.
- Required:
Yes - Example:
apple
Request Example
{
"query": "apple"
}
curl https://api.tradedata.io/api/v1/businessContact/fuzzy \
-H "Authorization: Bearer yourTokenHere" \
-H "Content-Type: application/json" \
-d '{"query": "apple"}'
import requests
response = requests.post(
"https://api.tradedata.io/api/v1/businessContact/fuzzy",
headers={
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
json={
"query": "apple",
},
)
print(response.json())
const response = await fetch("https://api.tradedata.io/api/v1/businessContact/fuzzy", {
method: "POST",
headers: {
"Authorization": "Bearer yourTokenHere",
"Content-Type": "application/json",
},
body: JSON.stringify({
"query": "apple"
}),
});
const data = await response.json();
<?php
$ch = curl_init("https://api.tradedata.io/api/v1/businessContact/fuzzy");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer yourTokenHere",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"query" => "apple"
]),
]);
echo curl_exec($ch);
Response parameters
data.company
array
Matched companies.
data.company.score
number
Match relevance score.
- Example:
1
data.company.id
string
Company ID.
- Example:
5b1b2c3d4e5f000000000001
data.company.name
string
Company name.
- Example:
Apple
data.company.website
string
Company website.
- Example:
apple.com
data.company.industry
string
Industry.
- Example:
electrical/electronic manufacturing
data.company.numberOfEmployees
integer
Employee count.
- Example:
164000
data.company.sortId
string
Sort identifier.
- Example:
5c1b2c3d4e5f000000000001
data.people
array
Matched people.
data.people.score
number
Match relevance score.
- Example:
0.9259259402751923
data.people.id
string
Person ID.
- Example:
5a1b2c3d4e5f000000000005
data.people.name
string
Person name.
- Example:
Jane Smith
data.people.modality
string
Data source modality.
- Example:
contacts
data.people.organization_name
string
Company name.
- Example:
Acme Corp
data.people.title
string
Job title.
- Example:
Sales Manager
Response Example
{
"code": 200,
"success": true,
"data": {
"company": [
{
"score": 1,
"website": "apple.com",
"sortId": "5c1b2c3d4e5f000000000001",
"name": "Apple",
"industry": "electrical/electronic manufacturing",
"id": "5b1b2c3d4e5f000000000001",
"numberOfEmployees": 164000
}
],
"people": [
{
"score": 0.9259259402751923,
"modality": "contacts",
"name": "Jane Smith",
"id": "5a1b2c3d4e5f000000000005",
"organization_name": "Acme Corp",
"title": "Sales Manager"
}
]
},
"msg": "OK",
"total": 0,
"pageSize": 0,
"current": 0,
"sumResult": null
}