# Company Intent Signals (`cag_ai-actors/company-intent-signals`) Actor

Look up which topics a company is researching. One domain in, intent topics out. $0.05 per successful lookup.

- **URL**: https://apify.com/cag\_ai-actors/company-intent-signals.md
- **Developed by:** [CAG Signals](https://apify.com/cag_ai-actors) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 company intent lookups

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Company Intent Signals

Given a company domain (or LinkedIn company URL), find out which topics that company's people are currently researching — real buying-intent signal for account-based marketing and sales prioritization, powered by Delivr.ai's identity and intent graph.

### Which Actor should I use?

We publish four Actors. Start at the top.

1. **Company Intent Signals** — first look, one domain, $0.05. https://apify.com/cag\_ai-actors/company-intent-signals
2. **B2B Account Intent Finder** — new companies on your topics. Preview up to 25 companies, then $0.15 per matched account. https://apify.com/cag\_ai-actors/b2b-account-intent-finder
3. **B2B Buyer Intent Enrichment** — you already have a list. $0.15 per match. https://apify.com/cag\_ai-actors/b2b-buyer-intent-enrichment
4. **Topic-Based Lead Prospecting** — Later. For new companies from a theme, use Account Intent Finder. For a first look at one company, use Company Intent Signals. https://apify.com/cag\_ai-actors/topic-based-lead-prospecting

This is the **simplest, single-lookup** tool in our intent-data lineup — one domain in, its intent topics out, nothing else. If you need more than that, see "Which tool should I use?" below.

### What you get

For each company you submit, a dataset item with:

- `matched` — whether the company was resolved
- `matched_on` — which identifier resolved it (`domain` or `linkedin_company_url`)
- `topics` — an array of matched intent topics, each with:
  - `topic_name` — the researched topic
  - `score` — intent tier (`high` or `medium`)
  - `perc_score` — percentile intent score
  - `people_count` — number of people at that company showing intent on this topic

**No person-level data is included.** This Actor returns company-level intent signals only — no names, emails, or other personal information.

### Which tool should I use?

We publish three Delivr.ai-powered intent tools. They answer different questions — pick by what you're trying to do:

| Tool | Question it answers | Best for |
|---|---|---|
| **Company Intent Signals** (this one) | "What is *this specific company* researching?" | A quick, single-purpose lookup on a known company — no batch tooling, no extra modes, lowest price. |
| **B2B Buyer Intent Enrichment** | "Add intent data to a list I already have" | Bulk enrichment (up to 10,000 records per run) of *either* people *or* companies, with cost-preview and demo modes before you commit spend. |
| **B2B Account Intent Finder** | "Which *new* companies are researching a topic?" | Prospecting/lead discovery — you give a topic, it finds and ranks the companies, not the other way around. |

If you're enriching an existing list, or need person-level data, or want to preview costs before charging — use **B2B Buyer Intent Enrichment** instead. If you're discovering new accounts from a topic, use **B2B Account Intent Finder**. Use this Actor when you already know the company and just want a fast, simple answer.

### Input

```json
{
  "companies": [
    { "domain": "example.com" },
    { "linkedinCompanyUrl": "https://linkedin.com/company/acme" }
  ]
}
```

Each entry needs either a `domain` or a `linkedinCompanyUrl`. An entry with neither isn't rejected at input time (Apify's schema validator can't express "one of these two fields") — it comes back in the output as an `error` item instead, and isn't charged.

### Pricing

Pay-per-event: one `company-intent-lookup` charge per successfully looked-up company. Companies that fail to resolve are still returned in the output (with an `error` field) and are not charged.

### Notes

- Unmatched companies return `matched: false` with an empty `topics` array — this is a normal result, not an error.
- Set `ACTOR_MAX_TOTAL_CHARGE_USD` on the run to cap total spend for large input lists.

# Actor input Schema

## `companies` (type: `array`):

Companies to look up. Each entry needs either a domain or a LinkedIn company URL. One Pay-Per-Event charge is billed per successfully looked-up company.

## Actor input object example

```json
{
  "companies": [
    {
      "domain": "example.com"
    }
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companies": [
        {
            "domain": "example.com"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("cag_ai-actors/company-intent-signals").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "companies": [{ "domain": "example.com" }] }

# Run the Actor and wait for it to finish
run = client.actor("cag_ai-actors/company-intent-signals").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companies": [
    {
      "domain": "example.com"
    }
  ]
}' |
apify call cag_ai-actors/company-intent-signals --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cag_ai-actors/company-intent-signals"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/q230mjxBSlyeS1alm/builds/ShnxzHFxSb2aLlGaR/openapi.json