curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/data/companies/resolve \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"domain": "<string>",
"linkedinUrl": "<string>"
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/data/companies/resolve"
payload = {
"name": "<string>",
"domain": "<string>",
"linkedinUrl": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', domain: '<string>', linkedinUrl: '<string>'})
};
fetch('https://api.tryfuse.ai/api/v1/business/data/companies/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "found",
"company": {
"name": "Stripe",
"domain": "stripe.com",
"linkedinUrl": "linkedin.com/company/stripe",
"logoUrl": "https://logo.example.com/stripe.png"
},
"creditsCharged": 0
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Find a company's domain, LinkedIn page and logo (free)
Find a company’s website domain, LinkedIn company page and logo from its name, website domain or LinkedIn URL. Free: no credits are charged.
Send at least one of name (e.g. “Stripe”), domain (e.g. “stripe.com”; a full URL is reduced to its domain) or linkedinUrl (e.g. “linkedin.com/company/stripe”). When several are sent, only the most precise is looked up: linkedinUrl, then domain, then name. A name resolves to the best-known company of that name, so send a domain or LinkedIn page for common names.
The answer carries status (found or not_found), company (name, domain, linkedinUrl and logoUrl, each null when unknown; company itself is null when nothing matches) and creditsCharged (always 0). A company nothing matches is a 200 not_found, never a guess. A lookup the company data provider cannot answer in time answers 504 and caches nothing: retry. Next: pass the domain to POST /companies/search as filters.domains for the full company record.
Only keys whose usage plan includes company_resolve may call it. Rate limit: the plan’s company_resolve entry.
Errors:
403API_NOT_ON_PLAN— The key’s usage plan does not includecompany_resolve.422COMPANY_IDENTIFIER_INVALID—domainis not a website domain, orlinkedinUrlis not a LinkedIn company page.429RATE_LIMITED— The plan’s per-minute or per-day limit forcompany_resolveis spent, or the company data provider is busy: retry shortly.
Requires one of the following token scopes: data.
curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/data/companies/resolve \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"domain": "<string>",
"linkedinUrl": "<string>"
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/data/companies/resolve"
payload = {
"name": "<string>",
"domain": "<string>",
"linkedinUrl": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', domain: '<string>', linkedinUrl: '<string>'})
};
fetch('https://api.tryfuse.ai/api/v1/business/data/companies/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "found",
"company": {
"name": "Stripe",
"domain": "stripe.com",
"linkedinUrl": "linkedin.com/company/stripe",
"logoUrl": "https://logo.example.com/stripe.png"
},
"creditsCharged": 0
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Your API token (af_…) as the Basic-auth username, with an empty password.
Body
At least one of name, domain or linkedinUrl. When several are given, only the most precise one is looked up: linkedinUrl, then domain, then name.
The company's name, e.g. Stripe. The least precise identifier: used only when no domain or linkedinUrl is given.
1 - 255The company's website domain, e.g. stripe.com; a full URL such as https://www.stripe.com/about is reduced to its domain.
1 - 253The company's LinkedIn page, e.g. https://www.linkedin.com/company/stripe, company/stripe or the bare slug stripe.
1 - 2048