Skip to main content
POST /v1/lookalike answers: which companies look like these? Send the domains of companies you want more of, such as your best customers. Agentic ID reads what they have in common, searches for companies that fit, and ranks them by how alike they are. Use it when you can name good examples more easily than filters.
200

Request

string[]
required
Domains of companies you want more of. 1 to 50. Each up to 253 characters.
integer
default:"25"
The most companies to deliver. 1 to 500.
boolean
default:"true"
Skip companies already delivered to your workspace.
string
default:"b2b_outbound"
Why you are asking. One of b2b_outbound, ad_audience, own_customer_enrichment, fraud_check. The call is refused if your workspace has not allowed the purpose.
integer
The most this call may charge. 0 to 100000. Never charged past it.

Response

string
required
The ID of this call. The same value as the X-Request-Id header.
string
required
One plain sentence: how many lookalikes from how many seeds, the charge, and why fewer came back than asked if that happened.
object
required
object
required
What the seeds have in common. This is the search that was run.
object[]
required
Seeds that could not be used, each with domain and reason.
number
required
Share of results bigger than your largest seed, from 0 to 1. A high value means the list leans to large, well-known companies.
object[]
required
The companies delivered, most alike first.
object
required
Why candidates were left out, as reason and count.
object[]
required
Which source was asked and what it could filter itself, each with provider and why.

What it costs

  • quoted_credits is max_accounts, or max_credits if that is lower.
  • When max_credits is reached the search stops, and the summary says so.
  • If your balance covers only part of the request, the part it covers is delivered.
  • This reply has no stopped_early field. When the search stops at one of Agentic ID’s own limits on paid sources, the summary says which one and what to do. The reasons are the same as for Discover.
See Credits for how holds and charges work.

Errors

See Errors for the full list.

Behaviour

  • Seeds are domains. A seed that is not a readable domain, or about which nothing is known, is listed in seeds_rejected and left out of the profile. The call still runs on the rest.
  • Seeds never come back. A seed is not returned as a lookalike of itself.
  • Read profile first. It is the search that was run. If it is too broad, send seeds that have more in common.
  • Watch bigger_than_seeds. When a quarter or more of the results are bigger than your largest seed, the summary says so.
  • exclude_seen is on by default. Asking again returns the next companies. Those already delivered to your workspace are skipped.
  • Same checks as Discover. Companies are judged and charged as in Discover, including size_check.
  • Companies only. To get people at the companies returned, call Find with each id.