Skip to main content
The opportunities endpoint does the ranking, the exclusions and the contact selection for you. This guide adds the two steps that make the list trustworthy: the explanation behind each company and the check for existing relationships.
1

Pull today's opportunities

cURL
Without dates the window is today. Companies are ranked by engagement_score over the last 90 days. The default relationship=prospects leaves out companies already in a connected CRM or tagged customer, competitor or not-interesting, and AI assistants and shared-network traffic never appear.Each item has a company (a full company row) and a contact:
source is visitor when the person identified themselves on your website and contact when they come from Leadinfo’s contact database. Only the first kind is known to have visited.
2

Explain the top companies

cURL
The response lists each pillar with the rules matched and missed, the pages viewed, known facts and unknown gaps. Put the three questions side by side in your hand-off: does the company fit (fit pillar), did it show interest (intent and engagement, with the page topics), and is a next step justified (people pillar, CRM status, tags).
3

Choose the action

A practical mapping:
4

Refine the person

When the recommended contact does not fit, list alternatives with GET .../companies/{company_id}/contacts?persona_id=14229, or fall back to dmu=marketing or department=leadership at small companies where titles are informal.
Keep page-level behaviour out of the message you send. Describe the topic the company showed interest in as a possible need, and never imply that the contact personally visited unless they are an identified visitor.