API reference

Look up a company

GET /api/v1/lookup

Returns the company record for a domain, with optional ICP fit score.

Name	Type	Required	Description
domain	string	Yes	Company domain, e.g. attio.com. URLs are accepted and normalised.
icp	string	No	One sentence describing your ideal customer. Adds fit. Falls back to your saved ICP.
fresh	boolean	No	true skips the 7-day cache.

Response fields

Name	Type	Description
name, description, industry	string \| null	What the company does.
hiring	object \| null	Open roles by team and roles posted in the last 30 days.
tech	array	Detected tools with category.
ads	object \| null	Active and new Meta ads (when the ads source is connected).
why_now / why_now_line	array / string	Signals that fired and a one-line summary.
opener	string \| null	Suggested first line, built only from a real signal.
fit	object \| null	0 to 100 score with overall, industry and size parts.
sources, as_of	object / string	Where each field came from and when.
no_match, credits_charged, credits_remaining	boolean / number	Whether anything was found, what this call cost (0 for no match or a 7-day repeat), and your balance.

{ "domain": "attio.com", "name": "Attio", "description": "The system for revenue teams to build pipeline, accelerate deals, and grow accounts around the clock.", "industry": "Sales & marketing tech", "employee_range": null, "hq_country": null, "hiring": { "total": 31, "sales": 7, "engineering": 15, "marketing": 4, "ops": 1, "posted_last_30d": 1 }, "tech": [ { "name": "Google Workspace", "category": "Email" }, { "name": "Stripe", "category": "Payments" }, { "name": "Mailchimp", "category": "Email sending" }, { "name": "Next.js", "category": "Framework" } ], "ads": null, "why_now": [ { "tag": "hiring_sales", "text": "Hiring 7 sales roles" }, { "tag": "hiring_marketing", "text": "Hiring 4 marketing roles" } ], "why_now_line": "Scaling sales and building marketing: hiring 7 sales roles, hiring 4 marketing roles.", "opener": "Saw you're hiring 7 sales roles. How are you getting new reps up to speed on accounts?", "fit": { "score": 64, "verdict": "Possible fit.", "parts": { "overall": 56, "industry": 78, "size": null } }, "sources": { "identity": "website meta description (checked by jev-1.14.0)", "industry": "jev-1.14.0 (from website text)", "hiring": "ashby job board (linked from their site)", "tech": "website scripts, headers and DNS", "ads": null }, "as_of": "2026-10-25T03:31:47.229Z", "no_match": false, "credits_charged": 50, "credits_remaining": 950 }