Look Up Account - Topo

POST

/

v1

/

accounts

/

lookup

Lookup Account

curl --request POST \
  --url https://api.topo.io/v1/accounts/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_url": "<string>",
  "domain": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({linkedin_url: '<string>', domain: '<string>'})
};

fetch('https://api.topo.io/v1/accounts/lookup', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.topo.io/v1/accounts/lookup"

payload = {
    "linkedin_url": "<string>",
    "domain": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "found": true,
  "name": "<string>",
  "domain": "<string>",
  "linkedin_url": "<string>",
  "logo_url": "<string>",
  "industries": [],
  "employee_count": 123,
  "headcount_growth_6m": 123,
  "country": "<string>",
  "year_founded": "<string>",
  "revenue_lower_usd": 123,
  "revenue_upper_usd": 123,
  "last_funding_round_type": "<string>"
}

Find a company in Topo’s lead database and read its firmographics: industries, headcount and growth, headquarters country, founding year, revenue range and last funding round. The LinkedIn company page is the surest match; the domain is tried when the page is unknown. A domain shared by several companies returns found: false. Nothing is written to your workspace and no credit is spent: use POST /v1/accounts to save the company as an account. Requires the accounts:read scope on the API key.

Authorizations

Authorization

string

header

required

Bearer API key issued from Settings → Developers.

Body

application/json

Lookup Account payload

linkedin_url

string | null

LinkedIn company page URL, the surest match.

domain

string | null

Website domain.

Response

200 - application/json

Successful Response

found

boolean

required

Whether Topo's lead database holds exactly one matching company.

name

string | null

Company name.

domain

string | null

Primary domain.

linkedin_url

string | null

LinkedIn company page URL.

logo_url

string | null

Logo URL.

industries

string[]

Industries.

employee_count

integer | null

Headcount.

headcount_growth_6m

number | null

Headcount growth over the last six months, in percent.

country

string | null

Headquarters country.

year_founded

string | null

Founding year.

revenue_lower_usd

integer | null

Lower bound of the estimated yearly revenue.

revenue_upper_usd

integer | null

Upper bound of the estimated yearly revenue.

last_funding_round_type

string | null

Type of the last funding round.

Lookup Account

curl --request POST \
  --url https://api.topo.io/v1/accounts/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_url": "<string>",
  "domain": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({linkedin_url: '<string>', domain: '<string>'})
};

fetch('https://api.topo.io/v1/accounts/lookup', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.topo.io/v1/accounts/lookup"

payload = {
    "linkedin_url": "<string>",
    "domain": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "found": true,
  "name": "<string>",
  "domain": "<string>",
  "linkedin_url": "<string>",
  "logo_url": "<string>",
  "industries": [],
  "employee_count": 123,
  "headcount_growth_6m": 123,
  "country": "<string>",
  "year_founded": "<string>",
  "revenue_lower_usd": 123,
  "revenue_upper_usd": 123,
  "last_funding_round_type": "<string>"
}