Skip to main content
POST
Enrich companies (beta)
The Enrichment API is in beta. Its request and response shapes can change.
Matches up to 25 companies, each by website, LinkedIn page or name. See the Enrich guide for how to read each result.

Notes

  • To authenticate, send your Tako API key in the X-API-Key header. Store it as an environment variable rather than hardcoding it.
  • The response carries its list as a card. To get the rows, pass the card’s webpage_url to Contents, or set include_contents on this request.
  • Premium fields are withheld. Export the card through Contents with premium set to true to reveal them.
  • The schema CompanyListField lists the card’s fields. See What a list holds.
  • Each successful request bills one request. See Pricing.

Authorizations

X-API-Key
string
header
required

Body

application/json
items
CompanyEnrichItem · object[]
required
Required array length: 1 - 25 elements
include_contents
boolean
default:false

Inline the card's rows in the response, under card.content. Premium fields are never inlined: pass the card's webpage_url to POST /api/v1/contents with premium=true to unlock them.

max_rows
integer | null

Maximum number of rows to inline when include_contents is true. Omit it and Tako uses your account's inline row cap. Tako clamps a larger value to the card's export_pricing.max_rows_ceiling (at most 100,000). Every inlined row is billed at the POST /api/v1/contents rate. For the rest of the list, call POST /api/v1/contents with the card's webpage_url and an offset. A card export can hold up to 100,000 rows. Don't read a large export directly into a model's context: at about 15 tokens per row, 10,000 rows cost about 150,000 tokens. Write the export to a file, on disk or in memory, and have the agent parse it with code. Give the model only the rows or results it needs.

Required range: x >= 1
content_format
enum<string>
default:json_compact

Serialization for the inlined rows: 'json_compact', 'json_records', 'csv', or 'card_json'.

Available options:
csv,
json_records,
json_compact,
card_json

Response

Enrich companies (beta)

results
CompanyEnrichResult · object[]
required

One result per item, in request order.

card
TakoCard · object | null

The matched records as one Tako card, in request order: embed it, inline its rows with include_contents, or pass its webpage_url to POST /api/v1/contents for premium fields (premium=true). CompanyListField names its fields. Null when nothing matched.