> ## Documentation Index
> Fetch the complete documentation index at: https://docs.data.avina.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Find and monitor signals

> Find companies showing a buying signal, keep finding new ones on a schedule, and watch the accounts you already have.

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.

| You want to | Use | Status |
| - | - | - |
| **Find** companies showing a signal right now | [Company search](#find-companies-showing-a-signal) | Available |
| **Monitor** for new companies showing it, every day or week | [A monitored search](#monitor-a-signal) | Available |
| **Watch** a list of companies you already have, and hear when one of them shows it | [Watch](#watch-the-accounts-you-already-have) | Coming Soon |

## 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.

```json Request theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "US fintech companies with 200 to 2,000 employees that hired a Chief Information Security Officer in the last 90 days",
  "limit": 25,
  "max_cost_usd": 25
}
```

```json One result (shortened) theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "name": "Northwind Pay",
  "domain": "northwindpay.example",
  "employee_count": { "low": 201, "high": 500 },
  "matched_criteria": [
    {
      "criterion": "new_hires",
      "verdict": "matched",
      "evidence": {
        "summary": "1 new hire matches.",
        "sources": ["https://www.linkedin.com/in/dana-whitfield-example"],
        "items": [
          { "type": "hire", "name": "Dana Whitfield", "title": "Chief Information Security Officer", "started_at": "2026-10-06" }
        ]
      }
    }
  ],
  "found_at": "2026-11-12T17:03:40Z"
}
```

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.

> [!TIP]
>
> 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.

```json Plain language theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "Software companies with 200 to 2,000 employees that hired a VP of Sales or Chief Revenue Officer in the last 60 days",
  "limit": 25,
  "max_cost_usd": 25
}
```

```json Structured theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "filters": {
    "all": [
      { "field": "company.industry", "operator": "in", "value": ["Software Development"] },
      { "field": "company.employee_count", "operator": "between", "value": [200, 2000] },
      {
        "related": {
          "relationship": "new_hires",
          "where": { "all": [
            { "field": "title", "operator": "in", "value": ["VP Sales", "Vice President of Sales", "Chief Revenue Officer", "CRO"] },
            { "field": "started_at", "operator": "within_last_days", "value": 60 }
          ] }
        }
      }
    ]
  },
  "limit": 25,
  "max_cost_usd": 25
}
```

### 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.

```json Plain language theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "US healthcare companies hiring a Head of Data or Director of Analytics, with a job posted in the last 30 days",
  "limit": 25,
  "max_cost_usd": 25
}
```

```json Structured theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "filters": {
    "all": [
      { "field": "company.industry", "operator": "in", "value": ["Hospitals and Health Care"] },
      { "field": "company.headquarters.country", "operator": "in", "value": ["US"] },
      {
        "related": {
          "relationship": "open_jobs",
          "where": { "all": [
            { "field": "title", "operator": "in", "value": ["Head of Data", "Director of Analytics"] },
            { "field": "posted_at", "operator": "within_last_days", "value": 30 }
          ] }
        }
      }
    ]
  },
  "limit": 25,
  "max_cost_usd": 25
}
```

### Funding

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

```json Plain language theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "Software companies in the US or Canada that raised a Series A or Series B in the last 90 days",
  "limit": 50,
  "max_cost_usd": 40
}
```

```json Structured theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "filters": {
    "all": [
      { "field": "company.industry", "operator": "in", "value": ["Software Development"] },
      { "field": "company.headquarters.country", "operator": "in", "value": ["US", "CA"] },
      { "field": "company.last_funding_round", "operator": "in", "value": ["series_a", "series_b"] },
      { "field": "company.last_funding_date", "operator": "within_last_days", "value": 90 }
    ]
  },
  "limit": 50,
  "max_cost_usd": 40
}
```

### Technology in use

Find companies that use a product you integrate with, compete with, or replace. This kind of data is often called technographics.

```json Plain language theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "Companies with 100 to 1,000 employees that use Salesforce and Snowflake",
  "limit": 50,
  "max_cost_usd": 40
}
```

```json Structured theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "filters": {
    "all": [
      { "field": "company.technologies", "operator": "in", "value": ["Salesforce"] },
      { "field": "company.employee_count", "operator": "between", "value": [100, 1000] }
    ]
  },
  "criteria": [{ "text": "uses Snowflake as its data warehouse", "kind": "attribute" }],
  "limit": 50,
  "max_cost_usd": 40
}
```

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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "B2B software companies where a founder or executive posted on LinkedIn in the last 30 days about replacing spreadsheets for revenue forecasting",
  "limit": 25,
  "max_cost_usd": 30
}
```

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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "Dental groups in Texas, Florida or Arizona that opened a new location in the last 6 months",
  "limit": 25,
  "max_cost_usd": 30
}
```

## 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.

> [accordion] 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"

> [accordion] 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"

> [accordion] 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"

> [accordion] 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"

You can combine several signals with fit in one sentence:

```json Request theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "Series B or later fintech companies in the US that hired a Chief Information Security Officer in the last 90 days and are hiring security engineers",
  "limit": 25,
  "max_cost_usd": 40
}
```

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:

```json Interpretation (shortened) theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "filters": {
    "all": [
      { "field": "company.industry", "operator": "in", "value": ["Financial Services"] },
      { "field": "company.headquarters.country", "operator": "in", "value": ["US"] },
      { "field": "company.last_funding_round", "operator": "in", "value": ["series_b", "series_c", "series_d", "series_e"] },
      { "related": { "relationship": "new_hires", "where": { "all": [
        { "field": "title", "operator": "in", "value": ["Chief Information Security Officer", "CISO"] },
        { "field": "started_at", "operator": "within_last_days", "value": 90 }
      ] } } },
      { "related": { "relationship": "open_jobs", "where": { "all": [
        { "field": "title", "operator": "in", "value": ["Security Engineer"] }
      ] } } }
    ]
  }
}
```

### 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](https://docs.data.avina.io/capabilities/parse.md) 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](https://docs.data.avina.io/guides/contacts-with-personas.md).

## 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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "Software companies with 200 to 2,000 employees that hired a VP of Sales or Chief Revenue Officer in the last 60 days",
  "limit": 25,
  "max_cost_usd": 25,
  "monitor": { "frequency": "daily" }
}
```

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](https://docs.data.avina.io/guides/scheduled-searches.md) covers the details.

## Watch the accounts you already have

> [!NOTE]
>
> **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.

```json POST /v1/companies/watches theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "query": "hired a new Chief Information Officer",
  "company_domains": ["northwindpay.example", "ledgerline.example", "harborfreightco.example"],
  "frequency": "daily",
  "max_cost_usd": 10
}
```

Things you can watch a list for:

| Condition | Example |
| - | - |
| New hires | "hired a new Chief Information Officer" |
| New job listings | "posted a job for a Salesforce administrator" |
| Expansion | "opened a new location" or "announced a new office" |
| Funding | "raised a new funding round" |
| Announcements | "announced an acquisition", "launched a new product" |
| Technology | "started using Snowflake" |

### Who it is for

> [card] 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.

> [card] 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.

> [card] Investors
>
> Watch a portfolio or a pipeline of companies for hires, launches and funding news.

> [card] 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](https://docs.data.avina.io/capabilities/watch.md) for the planned contract.

## Related

* [Scheduled searches](https://docs.data.avina.io/guides/scheduled-searches.md): monitor any search daily or weekly
* [Watch](https://docs.data.avina.io/capabilities/watch.md): planned events for a list of companies
* [Filter reference](https://docs.data.avina.io/guides/structured-filters.md): the fields behind hiring, funding and technology signals
* [Evidence and verdicts](https://docs.data.avina.io/concepts/evidence.md): how each signal is confirmed


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.