Look up intent for many identifiers

post

https://api.delivr.ai/api/v1/intent/batch

Resolve up to 10,000 identifiers in one call, each a hem, an email or a linkedin_url, mixed freely. Results are returned in input order, one per item; each echoes the supplied id. Page through this limit for larger audiences. Each item may instead carry a person_id from an earlier response. As on the single lookup, every item is matched to the person who holds the identifier and returns that person's topics across all their addresses, so more items can match than when each address was read on its own. Each item that resolved to a person returns their person_id; an address we cannot resolve to a person matches on its own intent, and resolve_person: true still widens it to the person's other addresses. An opted-out identifier never matches.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Cost-preview mixin. Add dry_run to any intent request to price it without billing.

topic_ids

array of strings

Return only these topic IDs. Omit or empty = all topics.

topic_ids

min_score

string

enum

Minimum intent tier to return. high returns only high, medium returns high+medium, and omitting it or low returns all three.

Allowed:

resolve_person

boolean

Defaults to false

A hem, email or linkedin_url that resolves to a person is matched across every address we hold for them whether or not this is set. For a hem or email we cannot resolve to a person, true widens the match to the other addresses that person holds, as before; false matches only the address supplied. matched_on reports the identifier you supplied. Billing stays one record per matched item. Default false.

dry_run

boolean

When true, the request is fully resolved and the exact billable quantity is returned as a cost preview (records_to_charge), but nothing is billed and no results (topics or records) are returned. Use it to preview cost before a live call. Because any address a person holds resolves them on the lookup and batch endpoints, a dry run can count more matches than it did when each address was matched on its own. Default false.

items

array of objects

required

length between 1 and 10000

items*

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Per-item results plus a matched tally.

400Invalid request: missing email or domain, empty items, more than 10,000 items, or a malformed body.

401Missing or invalid API credentials.