Name the seed company
POST /v2/contact/company/enrich returns RBID_ORG for a domain, so you can resolve once and reuse the id across many searches.
Control how close a match must be
Two ways to do it. Pick one — sending bothmatch and maxDistance is a 422.
Option 1 — a named preset
Sendmatch with one of four names. Each is a similarity floor calibrated for look-alikes specifically.
On target is the measured share of matches at that stop that genuinely fit. Presets are cumulative —
broad returns everything related would, plus a looser band beneath it.
Option 2 — your own similarity threshold
SendmaxDistance instead and put the floor wherever you like:
"maxDistance": 0.25. A raw maxDistance means exactly what it says and skips our calibration.
To find your own number, preview with "includeScores": true and read _companySimilarity on each row — they come back best-match first. Scroll to where results stop being useful and set your floor just above that. The POST /v2/contact/company/lookalike endpoint also returns a similarity score per match, which is a quick way to see the shape of a seed’s neighbourhood before committing to a threshold.
If you send neither
You getsimilar — a 70% similarity floor. Sending nothing is exactly the same search as sending "match": "similar", down to the same rows.
exact and similar are both strong. Past that, accuracy halves — related is a coin flip and broad is exploratory. Use the loose stops to find categories you hadn’t considered, then tighten.
Two endpoints, two jobs
Use the endpoint when you want to see and judge the neighbours, ranked by how close they are. Use the filter leg when you want a set cut at a threshold, combined with your other filters. Both take the samematch / maxDistance settings above, and both default to similar. The endpoint additionally takes an optional, uncapped limit — it pages what the floor already selected, so omitting it returns every company above the floor. Its response echoes the match and minSimilarity it ran at, plus a per-match similarity score.
Any of several seeds
Up to ten look-alike nodes per filter — far more headroom than the other two targets. Join them withOR so a company qualifies by resembling any seed:
Exclude a look-alike
There is no “not in” look-alike node. Wrap it in a group and negate:When a company has no vector
A company with no usable description has nothing to compare against.
The
404 is deliberate: it lets you tell “no similar companies exist” apart from “we can’t assess this company”. If a seed returns 404, pick a different one — usually a larger company in the same space.
