# In-Market Timing Score (`david15999/company-timing-score`) Actor

Tells you which companies to contact now: a 1-10 timing score per domain with the decision (contact now, nurture or wait) and the dated, linked buying trigger behind it. Live Google research plus hiring, 10-K and 8-K signals. Ready for Clay.

- **URL**: https://apify.com/david15999/company-timing-score.md
- **Developed by:** [David Emanuel Moreira](https://apify.com/david15999) (community)
- **Categories:** Lead generation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $35.00 / 1,000 company scoreds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## In-Market Timing Score

Give it a list of company domains. For each one you get a decision, not a pile of data: **contact
now**, **nurture** or **wait**, with a 1-10 timing score and the dated, linked buying trigger that
justifies it. Drop it into a Clay table and sort your accounts by who to call this week.

### How the score works

We run a fresh Google search on every company for the last 12 months and classify what we find
into buying triggers, then add the signals we already hold for the domain (hiring, 10-K security
and AI investment, 8-K cyber incidents). Each trigger has a weight, and fresher triggers count more:

| Trigger | Weight |
| --- | --- |
| Funding round, leadership change, cyber incident (8-K) | high |
| Acquisition, expansion, security incident | high |
| AI adoption, AI agent development, hiring, 10-K security or AI investment | medium |
| Product launch, partnership | low |
| Restructuring or layoffs | negative: budgets are likely frozen |

A trigger from the last 30 days counts fully, then 70% up to 90 days, 40% up to 180 days. The same
story told five times counts once, and one story backs one trigger only: each trigger is shown with
the headline that is actually about it. A trigger the research detected without a story that says
it plainly counts half and shows no headline. The score is plain arithmetic: the same evidence always gives
the same answer.

| Score | Decision |
| --- | --- |
| 7-10 | Contact now |
| 4-6 | Nurture |
| 1-3 | Wait (check again in 90 days) |

### Who it is built for

The trigger list and the stored signals were built for B2B technology sellers, above all security,
identity, data and AI. The score works best when your buyers are companies that buy that kind of
software.

- Security incidents, 10-K security and AI investment and 8-K cyber disclosures add points. For a
  seller in another category they may not mean budget for you.
- For companies outside tech, such as a restaurant chain or a local services firm, the score rests
  only on general triggers (funding, leadership, expansion, acquisition). Expect more Wait and
  Nurture results.
- It does not read your product or your ICP. Pair it with **ICP Fit Score** to first keep only the
  accounts that fit.

Try it on 20 accounts you already know before running a large list.

### Output

One row per domain: `timing_score`, `decision`, `action`, `why` (the strongest trigger with its date
and headline), `top_trigger`, `top_trigger_date`, `source_url`, and every trigger that counted.

### Pricing

| Event | Price | When |
| --- | --- | --- |
| `company-scored` | USD 0.05 (USD 50 per 1,000) | Per domain scored, with or without a trigger |

Every domain is a live search, so a domain with no trigger (score 1, Wait) is still charged. A
domain the search could not finish is not charged. The run never scores more domains than your
maximum charge allows. Example: 100 domains = USD 5.

### Timing

Domains run in batches of 25. A batch usually takes 2 to 15 minutes.

### Input

| Field | Notes |
| --- | --- |
| `domains` | Domains, website URLs or work emails |

### Related

**Company News Research** returns the raw signals behind the score, and **ICP Fit Score** tells you
whether a company fits your ideal customer at all.

### Data and privacy

Company-level data only. No personal data is returned.

### FAQ

**Which industries does it work best for?**
It is tuned for B2B tech sellers in security, identity, data and AI. For other markets it relies on general triggers only, so try it on 20 accounts you know first.

**How much does it cost?**
USD 50 per 1,000 domains scored. A domain with no trigger is still charged because the search ran.

**Should I use it with ICP Fit Score?**
Yes. ICP Fit says who to sell to, Timing says when. Together they give you a ranked list.

### More Compass actors

- [B2B Company Firmographics by Domain](https://apify.com/david15999/b2b-company-firmographics): industry, size, revenue, NAICS, tech stack and funding for a list of domains
- [Security and AI Buying Signals](https://apify.com/david15999/b2b-company-signals): dated breach, hiring, 10-K/8-K and AI adoption signals per company
- [Company News Research](https://apify.com/david15999/company-news-research): live search for funding, leadership, M\&A and expansion news on any domain
- [ICP Fit Score](https://apify.com/david15999/company-icp-fit): a 1-10 fit score per company against your ICP, written in plain words
- [Competitor Post Engagers](https://apify.com/david15999/competitor-engagers): people engaging with your competitors on LinkedIn, with verified work emails
- [Competitor Install Base](https://apify.com/david15999/competitor-install-base): companies that publicly use a competitor product, with the proof
- [Champion Job-Change Tracker](https://apify.com/david15999/champion-job-change): people from your customer accounts who moved to a new company
- [New-Hire Radar](https://apify.com/david15999/new-hire-radar): decision-makers in their first 6 months at companies like your customers
- [B2B Audience Behavioral Profile](https://apify.com/david15999/audience-profile): the themes, pains and voices your buyers follow, in one report

# Actor input Schema

## `domains` (type: `array`):

Company domains to score (acme.com). Website URLs and work emails are accepted too: the domain is extracted.

## Actor input object example

```json
{
  "domains": [
    "crowdstrike.com"
  ]
}
```

# Actor output Schema

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

One row per result in the default dataset.

# 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 = {
    "domains": [
        "crowdstrike.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("david15999/company-timing-score").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 = { "domains": ["crowdstrike.com"] }

# Run the Actor and wait for it to finish
run = client.actor("david15999/company-timing-score").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 '{
  "domains": [
    "crowdstrike.com"
  ]
}' |
apify call david15999/company-timing-score --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,david15999/company-timing-score"
        }
    }
}
```

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/Ub1Uo1ffbuuDAnrve/builds/nLlWqwkFmZnEVH4Py/openapi.json