Enrich companies and people

POST /v1/companies/enrich and POST /v1/people/enrich match records you already know. Send up to 25 items. The response has one result per item, in the order you sent them, and one card that holds the matched records.

Match companies

curl -X POST https://tako.com/api/v1/companies/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "domain": "stripe.com" },
      { "name": "Anduril", "country": "US" }
    ]
  }'

Each item needs at least one of these:

Field	How it matches
`domain`	The company’s website, matched exactly.
`linkedin_url`	The company’s LinkedIn page, matched exactly.
`name`	The company’s name, matched by score.

city, region, country and industry are hints for a name match. A hint ranks companies that fit it higher, and never excludes one.

Match people

curl -X POST https://tako.com/api/v1/people/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "linkedin_url": "https://www.linkedin.com/in/example" },
      { "name": "Jane Doe", "company_domain": "example.com", "title": "VP Sales" }
    ]
  }'

Each item needs at least one of these:

Field	How it matches
`email`	An email address, matched exactly.
`phone`	A phone number with its country code, such as `+1 415 555 0100`, matched exactly.
`linkedin_url`	A LinkedIn profile URL (`linkedin.com/in/...`), matched exactly.
`name`	The person’s name, matched by score.

company_domain, company_name and title are hints for a name match.

Read a result

Field	What it holds
`status`	`matched`, `no_match` or `failed`. `no_match` is an answer, not an error. `failed` means the lookup failed: retry the item.
`match_id`	The matched record’s id. Its profile is a row of the card.
`confidence`	`exact`, `high` or `ambiguous`. See below.
`matched_on`	The input that found the record: `domain`, `linkedin_url`, `email`, `phone` or `name`.
`alternates`	How many other records match nearly as well, up to 3.
`unresolved`	Inputs that named nothing, as `field=value`.
`failed`	Inputs whose lookup failed or timed out. Retry these; they aren’t misses.

confidence says how sure the match is:

exact: a website, LinkedIn URL, email or phone named the record.
high: the name match is well ahead of the next.
ambiguous: other records match nearly as well, or a website or LinkedIn page names more than one company. Check the record before you rely on it, or add a hint and send the item again.

The card

The card holds the matched records in request order. An item that didn’t match has a result and no row. card is null when nothing matched. See Get the rows and reveal premium fields for the rows, and What a list holds for the fields.

Billing

An enrich request bills one request, whatever the number of items. A request with any answered item, including a no_match, returns 200 and is billed. A request in which every lookup failed returns 503 and isn’t billed. See Pricing.

Getting Started

Build with Tako

API Reference

Integrations

Additional Resources

Enrich companies and people

Match companies

Match people

Read a result

The card

Billing

​Match companies

​Match people

​Read a result

​The card

​Billing

Match companies

Match people

Read a result

The card

Billing