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

# Company Signals API

> The Company Signals API returns the companies where a chosen buying signal just fired. Filter by signal name, look-back window, and signal strength, and get back companies with their firmographics and the signal that triggered.

## Common Use Cases

Turn any buying signal into a live list of the companies where it just fired.

* **Signal-Based Targeting:** Building account lists from a chosen signal.
* **Buying-Intent Detection:** Finding companies in a moment of change.
* **Market Monitoring:** Tracking how many companies hit a signal over time.
* **Account Prioritization:** Ranking accounts by signal strength and recency.

<Badge color="blue" size="lg" icon="star" className="mt-3">
  Credit usage is 2 per request.
</Badge>

## Attributes

<ParamField body="signal_name" type="string" required>
  The buying signal to filter by. Accepts the same values as the [People Signals API](/buying-signals/signals-apis/people-signals) — see the full list of available signal names there.
</ParamField>

<ParamField body="time_frame" type="integer" required>
  Look-back window in days. Allowed values: `7`, `30`, `90`, or `180`.
</ParamField>

<ParamField body="bucket" type="string" required>
  Signal strength. Allowed values: `low`, `moderate`, `high`, or `hyper`.
</ParamField>

<ParamField body="page" type="integer">
  Page number for paginated results.
</ParamField>

## Response

<CodeGroup>
  ```json Response theme={null}
  {
      "status": 1,
      "data": {
          "confidence_level": 95,
          "query": {
              "signal_name": "employee_growth",
              "time_frame": 30,
              "bucket": "low",
              "page": 1
          },
          "companies": [
              {
                  "name": "google",
                  "website": "https://google.com",
                  "domain": "google.com",
                  "employees": {
                      "range": "10001+"
                  },
                  "industry": "software development",
                  "overview": "a problem isn't truly solved until it's solved for all. googlers build products that help create opportunities for everyone, whether down the street or across the globe. bring your …",
                  "type": "public company",
                  "main_location": {
                      "country": "united states",
                      "state": "california",
                      "city": "mountain view",
                      "address": "1600 amphitheatre parkway,mountain view, ca 94043, us"
                  },
                  "social": {
                      "facebook": null,
                      "linkedin": "linkedin.com/company/google",
                      "twitter": null
                  },
                  "signal": {
                      "name": "employee_growth",
                      "time_frame": 30,
                      "bucket": "low"
                  }
              }
          ],
          "credit_count": 4757
      }
  }
  ```
</CodeGroup>

## Related APIs

<CardGroup cols={2}>
  <Card title="People Signals" icon="users" href="/buying-signals/signals-apis/people-signals">
    People at companies that triggered a signal.
  </Card>

  <Card title="Company Activity" icon="rss" href="/buying-signals/signals-apis/company-activity">
    Recent social posts for a company.
  </Card>

  <Card title="Company Search" icon="search" href="/apis/company-search">
    Search companies with multiple filters.
  </Card>

  <Card title="Company Enrichment" icon="building" href="/apis/company-enrichment">
    Enrich a company with full firmographics.
  </Card>
</CardGroup>