Find New Leads

Companies where something just happened: they are hiring, raised money, announced news or signed a partnership. Cornect follows about 8,900 companies and records each event as it is found, so these endpoints read what is already there. They are free: browsing charges no credits. To be told when a company does something next, watch it with a monitor.

Any token can call them (read), sent as Authorization: Bearer cornect_….

List leads#

GET/api/v1/leads

Newest first. By default there is one row per company: its newest signal, with company_signals saying how many it has in the window and company_families what kinds.

Query parameter	Type	Default	Description
`family`	string	—	Only one kind of event: funding, mna, leadership, hiring, expansion, contraction, commercial, product, technology, other.
`days`	integer, 1–365	30	Happened in the last N days. Job openings are kept for 90 days, everything else for a year.
`q`	string	—	Company name or domain contains this text.
`hide_watched`	boolean	false	Leave out companies your monitors already watch.
`domain`	string	—	Only this company (exact domain).
`per_company`	boolean	true	One row per company. false lists every signal.
`limit`	integer, 1–100	50	Page size.
`offset`	integer	0	Rows to skip.

curl -X GET https://api.cornect.io/api/v1/leads?family=funding&days=14 \
  -H "Authorization: Bearer cornect_your_token_here"

Response:

json

{
  "items": [
    {
      "id": "6b0e…",
      "domain": "acme.com",
      "company_name": "Acme",
      "signal_type": "news_events",
      "signal_label": "News Event",
      "family": "funding",
      "family_label": "Funding",
      "category": "receives_financing",
      "headline": "Acme raises $20M Series B led by Example Ventures",
      "details": ["Receives Financing", "$20 million", "2026-10-02"],
      "source_url": "https://news.example.com/acme-series-b",
      "happened_on": "2026-09-30",
      "found_at": "2026-10-02T08:14:00Z",
      "watched": false,
      "company_signals": 3,
      "company_families": ["funding", "hiring"]
    }
  ],
  "total": 214,
  "limit": 50,
  "offset": 0
}

Field	Type	Description
`id`	string
`domain`	string	The company's domain. Watch it with Create Monitor.
`company_name`	string
`signal_type`	string	`job_openings` (hiring), news, or `connections` (partnerships).
`signal_label`	string	The signal type, readable.
`family`	string	What kind of event: funding, mna, leadership, hiring, expansion, contraction, commercial, product, technology or other.
`family_label`	string	The family, readable.
`category`	string	For news: the event's category, e.g. `receives_financing`.
`headline`	string	What happened, in a line.
`details`	string[]	Short facts: location, amount, seniority and the like.
`source_url`	string	Where it was found: the job post or the article.
`happened_on`	string	When it happened (YYYY-MM-DD).
`found_at`	string	When it was found.
`watched`	boolean	Whether one of your monitors already watches this company.
`company_signals`	integer	How many signals this company has in the window, this one included.
`company_families`	string[]	The kinds of event among them.

A company's signals#

Everything recent at one company: pass its domain and per_company=false, with a longer window. An empty list means nothing was found for it in that window; coverage is the companies Cornect follows.

bash

curl "https://api.cornect.io/api/v1/leads?domain=acme.com&per_company=false&days=365&limit=100" \
  -H "Authorization: Bearer cornect_your_token_here"

Summary#

GET/api/v1/leads/summary

How many companies match, per kind of event. It takes the same days, q and hide_watched as List leads, but not family: the counts describe the set before that choice.