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)
Common signals
These are the signals most teams start with. Each one is a complete request body forPOST /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.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.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
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”
Change of direction
Change of direction
- “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”
Regulation and compliance
Regulation and compliance
- “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”
Pressure and pain
Pressure and pain
- “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”
Request
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.
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.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.
POST /v1/companies/watches
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.
Related
- Scheduled searches: monitor any search daily or weekly
- Watch: planned events for a list of companies
- Filter reference: the fields behind hiring, funding and technology signals
- Evidence and verdicts: how each signal is confirmed

