Find New Leads

Companies where something just happened: they are hiring, raised money, announced news or signed a partnership. Cornect follows about 11,500 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, repeatable	—	Only these kinds of event: funding, mna, leadership, hiring, expansion, contraction, commercial, product, technology, other. Repeat for several (family=funding&family=hiring). Technology (a newly detected technology) appears only when asked for.
`news_category`	string, repeatable	—	Only these news stories (acquires, partners_with, launches…), within their own family. The summary's by_news_category lists them.
`connection_type`	string, repeatable	—	Only connections of these types: partner, customer, vendor, integration, investor, other…
`exclude_connection_type`	string, repeatable	—	Leave out connections of these types, e.g. other.
`job_category`	string, repeatable	—	Only job openings in these departments: finance, sales, engineering, marketing, directors, management, operations, human_resources, information_technology, product, design, legal, customer_service, consulting, education, health, manufacturing, media, real_estate, research, administrative, other.
`seniority`	string, repeatable	—	Only job openings at these levels: founder, c_level, partner, president, vice_president, head, director, manager, mid_senior, junior.
`title`	string	—	Only job openings whose title has every one of these words (vp sales).
`min_open_roles`	integer, 2–100	—	Only companies with at least N job openings in the window that match the job filters.
`min_families`	integer, 2–5	—	Only companies with signals of at least N different kinds in the window, e.g. funding and hiring. Other and Technology do not count.
`technology`	string, repeatable	—	Only newly detected technologies with these names (HubSpot), as by_technology names them.
`days`	integer, 1–365	30	Happened in the last N days. Job openings are kept for 90 days, newly detected technologies for 30, 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.
`industry`	string, repeatable	—	Only companies in this industry sector: accommodation_food, admin_support, consumer_services, education, energy_utilities, farming, finance_insurance, government, healthcare_pharma, holding_companies, manufacturing, media_entertainment, nonprofit, professional_services, real_estate_construction, retail_consumer_goods, technology, telecommunications, transportation_logistics, wholesale. Repeat for several (industry=technology&industry=wholesale).
`size`	string, repeatable	—	Only companies with this many employees: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
`country`	string, repeatable	—	Only companies headquartered here, named as the summary's by_country names it (United States).
`funded_within_months`	integer, 1–60	—	Only companies whose last funding round was in the last N months.
`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.

The news, connection, job and technology filters narrow their own kind of event and leave the others alone: with family=funding&family=hiring&seniority=vice_president you get every funding lead and the hiring leads for VP roles. With no family, they pick theirs: seniority=vice_president alone lists hiring leads only.

curl -X GET https://api.cornect.io/api/v1/leads?family=hiring&job_category=sales&seniority=vice_president&industry=technology&size=51-200&country=United%20States \
  -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"],
      "industry": "technology",
      "industry_label": "Technology & IT Services",
      "company_size": "51-200",
      "company_size_label": "51–200",
      "country": "United States",
      "last_round_date": "2026-09-30"
    }
  ],
  "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, a funding round, `connections` (partnerships), or `technology_detections` (started using a technology).
`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.
`industry`	string	The company's industry sector, e.g. `technology` (see the `industry` filter).
`industry_label`	string	The sector, readable.
`company_size`	string	Employee range, e.g. `51-200`.
`company_size_label`	string	The range, readable.
`country`	string	Headquarters country, e.g. `United States`.
`last_round_date`	string	The company's last funding round we know of (YYYY-MM-DD).

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, industry sector, employee range and country. It takes the same filters as List leads. Each list ignores its own filter (with industry=technology, by_industry still counts every other sector). labels names the values your filters use, readable. The counts for the narrowing filters are Facets.

Industry, size, country and funding come from the company's profile. A company without one still appears in List leads, but not once one of those filters is set.

json

{
  "total": 1840,
  "companies": 612,
  "by_family": [
    { "family": "funding", "label": "Funding", "count": 41 },
    { "family": "hiring", "label": "Hiring", "count": 388 }
  ],
  "by_industry": [
    { "industry": "technology", "label": "Technology & IT Services", "count": 203 },
    { "industry": "wholesale", "label": "Wholesale", "count": 9 }
  ],
  "by_size": [
    { "size": "11-50", "label": "11–50", "count": 301 },
    { "size": "51-200", "label": "51–200", "count": 177 }
  ],
  "by_country": [
    { "country": "United States", "count": 402 },
    { "country": "United Kingdom", "count": 61 }
  ],
  "labels": { "seniority": { "vice_president": "VP" } },
  "companies_followed": 11570,
  "last_received_at": "2026-10-11T06:08:33Z"
}

Field	Type	Description
`total`	integer	Signals in the window.
`companies`	integer	Companies they belong to.
`by_family`	SignalFamilyCount[]	Companies per kind of event, zeros included.
`by_industry`	IndustryCount[]	Companies per industry sector, all 20, zeros included.
`by_size`	SizeCount[]	Companies per employee range, zeros included.
`by_country`	CountryCount[]	Companies per headquarters country, most first.
`labels`	object	Readable names for the values the request's filters use, by filter: `{"seniority": {"vice_president": "VP"}}`.
`companies_followed`	integer	Companies Cornect follows for new signals.
`last_received_at`	string	When the newest signal arrived.

GET/api/v1/leads/facets

The counts behind the narrowing filters, only the ones you name in facet (repeat it for several): news_category, connection_type, job_category, seniority, technology (newly detected, the last 30 days), open_roles (companies with 3, 5 and 10+ open roles) and signal_kinds (2 and 3+ kinds of signal). Same filters as List leads; each list ignores its own filter.

curl -X GET https://api.cornect.io/api/v1/leads/facets?facet=job_category&facet=seniority&family=hiring \
  -H "Authorization: Bearer cornect_your_token_here"

json

{
  "by_job_category": [
    { "category": "sales", "label": "Sales", "count": 121 },
    { "category": "engineering", "label": "Engineering", "count": 97 }
  ],
  "by_seniority": [
    { "seniority": "manager", "label": "Manager", "count": 140 },
    { "seniority": "vice_president", "label": "VP", "count": 12 }
  ]
}

Field	Type	Description
`by_news_category`	NewsCategoryCount[]	Companies per news category, most first.
`by_connection_type`	ConnectionTypeCount[]	Companies per connection type, most first.
`by_job_category`	JobCategoryCount[]	Companies hiring per department, most first.
`by_seniority`	SeniorityCount[]	Companies hiring per level, most first.
`by_technology`	TechnologyCount[]	Companies per newly detected technology, most first (top 30).
`by_open_roles`	StepCount[]	Companies with at least 3, 5 and 10 open roles in the window.
`by_signal_kinds`	StepCount[]	Companies with signals of at least 2 and 3 different kinds.

Errors#

Code	Status	When
`INVALID_TOKEN`	401	Token not found or revoked.
`INVALID_FILTER`	422	A family, news category, department, seniority, industry, size or facet that is not one of the values above; details lists the allowed ones.
—	422	A parameter is out of range.
—	429	Rate limit exceeded (120/min).

Find New Leads

List leads#

A company's signals#

Summary#

Facets#

Errors#

Related#