Skip to main content
A signal is a sign that something has changed at a company: a new executive, a job listing, a funding round, a new office, a post about a problem you solve. Signals tell you which companies to talk to now, and give you a reason to reach out. The Data API works with signals in three ways.

Find companies showing a signal

In the Data API, a signal is just a requirement of a company search. Describe the signal and the kind of company you want, and the search returns the companies where both are true, with evidence for the signal.
Request
One result (shortened)
The evidence is what makes a signal usable. Your team, or your AI agent, can open the message with the fact itself: who was hired, which job is open, what was announced, and where it was found.
A signal on its own returns too many companies. Combine it with fit: industry, size, location or funding stage. “Hired a new CISO” is a signal. “US fintechs with 200 to 2,000 employees that hired a new CISO” is a list you can work.

Common signals

These are the signals most teams start with. Each one is a complete request body for POST /companies/search.

New hires

A new leader usually reviews the tools and suppliers they inherit. Find companies where someone has just started in a role.

Job listings

An open job shows where a company is about to spend. A team hiring its first data engineer is building a data stack. A team hiring ten SDRs is scaling outbound.

Funding

Companies that have just raised have budget and a plan to grow.

Technology in use

Find companies that use a product you integrate with, compete with, or replace. This kind of data is often called technographics.
A company.technologies filter matches companies using any of the listed products. To require two products, keep one as a filter and add the other as a criterion, as above.

Social posts

What a company’s leaders post about is a signal of what they are working on. Describe the topic and a time frame.
Post signals are checked by research on the public web, and each result links to the post it found.

News and announcements

Anything a company has announced publicly can be a signal: a new location, a product launch, a partnership, an acquisition.

Signals in plain language

The examples above have fields or a common shape. Most real triggers do not, and that is where plain language helps: describe the event you care about, and each result comes back with the source that confirms it.

Expansion

  • “Mid-market logistics companies in the US that announced a new warehouse or distribution center in the last 90 days”
  • “E-commerce brands that started selling in a new country in the last 6 months”
  • “Restaurant groups with more than ten locations that announced plans to franchise this year”
  • “B2B software companies that announced a move from selling to small businesses to selling to enterprises this year”
  • “Healthcare providers that announced a switch to a new electronic health record system this year”
  • “Manufacturers that announced they are bringing production back to the US in the last 12 months”
  • “Fintech companies that were granted a new banking or money-transmitter licence this year”
  • “Software companies that announced SOC 2 or ISO 27001 certification in the last 6 months”
  • “US manufacturers that received a federal clean-energy grant this year”
  • “Companies whose CEO talked about cutting cloud costs in an interview, podcast or post in the last 90 days”
  • “Retailers that publicly reported a data breach in the last 12 months”
  • “SaaS companies that announced layoffs in their sales team in the last 90 days”
You can combine several signals with fit in one sentence:
Request
The search’s interpretation shows how the sentence was split into requirements. Every one of them must be true of a company for it to be returned:
Interpretation (shortened)

Writing signals that work

  • Describe something that happened or is true, and can be checked. “Opened a new location” works. “Is probably about to expand” does not.
  • Give a time frame. “In the last 90 days” or “this year”. Without one, “recently” is read as the last 90 days and reported as an assumption.
  • Stick to public information. Hires, jobs, funding, technology, announcements and posts are public. Visits to your website, opens of your emails and other activity on your own channels are not available through the API. A query that depends on them stops with query_needs_clarification.
  • Check the reading first. Parse shows how a sentence will be interpreted, for free.
To get the right people at each company along with the signal, add persona_ids. See Contacts with personas.

Monitor a signal

A signal search finds the companies showing the signal today. New companies will show it tomorrow. Monitor the search and it runs again every day or every week, adding only companies that were not in the results before.
Each run can add up to limit new companies and spend up to max_cost_usd. You read the new ones from the same results endpoint. Scheduled searches covers the details.

Watch the accounts you already have

Coming Soon. Watch is not available yet. This section describes how it is planned to work.
Find and Monitor answer “which companies are showing this signal?” Often you have the opposite question: you already know which companies matter, and you want to know the moment something happens at one of them. Watch takes a list of companies and a condition, checks the condition on a schedule, and records an event when a company’s answer changes.
POST /v1/companies/watches
Things you can watch a list for:

Who it is for

Enterprise and named-account sales

You sell to a fixed list of target accounts. Watch them for the events that open a conversation: a new executive, a reorganization, a relevant job listing.

Customer success

Watch your customers for signs of expansion, such as a funding round or a new office, and for risk, such as your champion leaving.

Investors

Watch a portfolio or a pipeline of companies for hires, launches and funding news.

Partnerships

Watch partners and prospects for announcements that change who you should be working with.
The difference from a monitored search is the starting point. A monitored search starts from a description and finds companies you did not know about. A watch starts from companies you chose and tells you when they change. See Watch for the planned contract.