REST API

Get live people results

Current result of find_people_live lookups (lookup_ids from its answer).

POST/v1/people/live/results

MCP tool get_live_people_resultscope email:findNo record cost

Parameters

lookup_idsstring[]required

(up to 10 items)

rolesstring[]optional

Keep only people whose title (or the answer’s section heading) contains one of these words, e.g. [‘ceo’,‘founder’,‘sales’,‘marketing’]. Case-insensitive. (up to 20 items)

only_source_confirmedbooleanoptional

Drop people whose name no cited page confirms (source_confirmed: false). Default false: they are shown, labelled.

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

Current result of find_people_live lookups (lookup_ids from its answer). People appear when the web search is done. Poll every 15–30 s; free to re-read. source_confirmed: true = the name appears in a page the answer cited (source_url); false = named by the AI answer only — AI answers can name people who do not exist, so treat those as leads to check (a mailbox found with find_email confirms them).

Errors follow one format.

Request

curl -X POST "https://api.breaknorm.co/v1/people/live/results" \
  -H "Authorization: Bearer $BREAKNORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lookup_ids": [
      "10482"
    ]
  }'