# Tavily Competitor News & Pricing Radar (`song921619730/tavily-competitor-news-radar`) Actor

Continuous market and competitor intelligence radar. Scans rival price moves, product launches, partnerships, and executive departures with time-bounded news filters ($0.030/run).

- **URL**: https://apify.com/song921619730/tavily-competitor-news-radar.md
- **Developed by:** [song](https://apify.com/song921619730) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

## Tavily Competitor News & Pricing Radar

> Continuous market intelligence tracker scanning rival pricing modifications, product launches, partnerships, and executive departures with time-bounded news filters.

[![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue?logo=apify)](https://apify.com)
[![Pricing](https://img.shields.io/badge/Pricing-Pay--Per--Event%20\($0.030\)-green)](https://apify.com)
[![Container](https://img.shields.io/badge/Container-256MB%20Optimized-orange)](https://docker.com)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue)](LICENSE)

***

### 💡 The Problem Solved

Maintaining continuous visibility into rival business actions is essential for modern e-commerce, SaaS, and enterprise strategy teams. However, traditional market intelligence software (such as Klue or Crayon) costs **$1,500 to $5,000+ per month**, requiring long-term annual contracts. Meanwhile, manual Google Alerts and PR searches produce overwhelming noise, missed pricing revisions, and stale signals.

**Tavily Competitor News & Pricing Radar** solves this by providing automated, high-precision competitive monitoring on demand:

- **Zero Monthly Subscription**: Pay only **$0.030 per radar scan** via Apify Pay-Per-Event (PPE).
- **Time-Bounded Precision**: Filter by `day` (24h), `week` (7d), or `month` (30d) to eliminate irrelevant historical archives.
- **Action-Focused Category Filters**: Zoom into pricing updates, product rollouts, partnerships, or leadership changes.
- **Automatic Strategic Impact Scoring**: Every signal is automatically scored as 🔴 **HIGH**, 🟡 **MEDIUM**, or 🔵 **INFO**.
- **Dual Deliverables**: Clean JSON pushed to the Apify Dataset for automated pipelines, plus an executive Markdown report (`RADAR_DIGEST.md`) ready for Slack, email, or executive review.

***

### 💰 Transparent Pay-Per-Event (PPE) Pricing

No monthly minimums, no seat licenses, and zero subscription commitments. You are charged strictly per completed radar scan:

| Billable Event | Unit Price | Description |
|---|---|---|
| `competitor_radar_run` | **$0.030 USD** | Full competitor radar scan across all designated targets with signals dataset and `RADAR_DIGEST.md` |
| `radar_scan_completed` *(alias)* | **$0.030 USD** | Event alias for completed radar scan executions |

*If validation fails prior to execution, you are charged $0.00.*

***

### 📥 Input Parameters

Configure via the Apify Web Console or pass JSON directly via API:

| Parameter | Type | Required | Default | Description |
|---|---|:---:|---|---|
| `competitors` | `array` | **Yes** | `["Shopify", "BigCommerce"]` | List of competitor company or brand names to monitor. |
| `tracking_category` | `string` | No | `"all"` | Filter corporate action: `"all"`, `"pricing_discounts"`, `"product_launches"`, `"partnerships"`, `"executive_moves"`. |
| `time_range` | `string` | No | `"week"` | Time window: `"day"` (24 hours), `"week"` (7 days), `"month"` (30 days). |
| `include_domains` | `array` | No | `[]` | Specific news sites to prioritize (e.g. `["techcrunch.com", "bloomberg.com", "prnewswire.com"]`). |
| `exclude_domains` | `array` | No | `[]` | Specific domains to omit (e.g. `["reddit.com", "pinterest.com"]`). |
| `max_items_per_competitor` | `integer` | No | `5` | Maximum signals to retrieve per competitor (1 to 15). |

#### Sample Input JSON

```json
{
  "competitors": ["Shopify", "BigCommerce", "WooCommerce"],
  "tracking_category": "pricing_discounts",
  "time_range": "week",
  "include_domains": ["techcrunch.com", "prnewswire.com", "reuters.com"],
  "max_items_per_competitor": 3
}
```

***

### 📤 Output Format

#### 1. Default Dataset Record

Every captured market signal is emitted as an individual record in the Apify Default Dataset:

```json
{
  "competitor": "Shopify",
  "headline": "Shopify Introduces New Cross-Border Merchant Pricing Tiers",
  "url": "https://techcrunch.com/2026/10/16/shopify-cross-border-fees",
  "summary": "Shopify announced updated commission schedules for cross-border retailers, introducing automated currency conversions.",
  "category": "pricing_discounts",
  "strategic_impact": "high",
  "relevance_score": 0.942,
  "published_date": "2026-10-16",
  "time_range": "week",
  "detected_at": "2026-10-18T18:15:00.000Z"
}
```

#### 2. Key-Value Store: `RADAR_DIGEST.md`

A Markdown report saved under `RADAR_DIGEST.md` ready for export or Slack distribution:

```markdown
## Competitor News & Pricing Radar Digest
**Generated:** 2026-10-18 18:15:00 UTC | **Time Horizon:** week | **Tracking Category:** pricing_discounts
**Monitored Competitors (2):** Shopify, BigCommerce
**Signal Tally:** Total: **3** | 🔴 High: **2** | 🟡 Medium: **1** | 🔵 Info: **0**

---

### Executive Summary
- Monitored **2** competitors over time window **week**.
- Detected **2** high-priority strategic signals (price alterations, leadership shifts, M&A).

---

### Competitor Signals Breakdown

#### Shopify (2 signals)
| Impact | Category | Headline & Source | Date | Relevance |
| :---: | :--- | :--- | :---: | :---: |
| 🔴 HIGH | Pricing Discounts | [Shopify Introduces New Cross-Border Pricing](https://techcrunch.com/...) | 2026-10-16 | 0.94 |
| 🔴 HIGH | Pricing Discounts | [Shopify Adjusts Enterprise Tiers](https://reuters.com/...) | 2026-10-15 | 0.91 |

#### BigCommerce (1 signals)
| Impact | Category | Headline & Source | Date | Relevance |
| :---: | :--- | :--- | :---: | :---: |
| 🟡 MED | Partnerships | [BigCommerce Partners with Global Merchant Logistics](https://example.com/...) | 2026-10-14 | 0.93 |
```

***

### ⚡ Integration Guides

#### Python (`apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")

## Trigger competitor news scan
run = client.actor("your-username/tavily-competitor-news-radar").call(
    run_input={
        "competitors": ["Stripe", "Adyen"],
        "tracking_category": "pricing_discounts",
        "time_range": "week",
        "max_items_per_competitor": 5,
    }
)

## Fetch signals from dataset
dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items
for signal in dataset_items:
    print(f"[{signal['strategic_impact'].upper()}] {signal['competitor']}: {signal['headline']}")

## Fetch Markdown Digest
digest = client.key_value_store(run["defaultKeyValueStoreId"]).get_record("RADAR_DIGEST.md")
print(digest["value"])
```

#### Make.com (Integromat)

1. Add an **Apify** module -> **Run an Actor**.
2. Select `tavily-competitor-news-radar`.
3. Map competitor lists from Airtable, Notion, or CRM tables into `competitors`.
4. Add a downstream **Slack** or **Microsoft Teams** module posting `RADAR_DIGEST.md` to your executive channel.

#### Zapier

1. Trigger: **Schedule by Zapier** (e.g. Every Monday at 8:00 AM).
2. Action: **Apify -> Run Actor** with `tavily-competitor-news-radar`.
3. Downstream Action: **Send Email via Gmail** or **Create Notion Page** populated with the detected dataset signals.

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/your-username~tavily-competitor-news-radar/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "competitors": ["Shopify", "BigCommerce"],
    "tracking_category": "all",
    "time_range": "week"
  }'
```

***

### 🛡️ Strategic Impact Classification

Signals are evaluated against an automated strategic impact scoring matrix:

- 🔴 **HIGH**: Explicit price jumps, fee tier changes, CEO/CFO departures or appointments, M\&A acquisitions, restructuring, or legal controversies.
- 🟡 **MEDIUM**: Major feature releases, platform integration announcements, strategic commercial partnerships, or regional expansions.
- 🔵 **INFO**: General press releases, interview commentary, awards, and minor platform patches.

***

### ⚖️ License & Attribution

Distributed under Apache-2.0. Powered by Apify Actor SDK and Tavily AI Search.

# Actor input Schema

## `competitors` (type: `array`):

List of competitor names or brand entities to track (e.g. \['Shopify', 'BigCommerce', 'WooCommerce']).

## `tracking_category` (type: `string`):

Filter signals by specific corporate action.

## `time_range` (type: `string`):

How far back to monitor news signals.

## `include_domains` (type: `array`):

Specific news outlets or press release sites to prioritize (e.g. \['techcrunch.com', 'bloomberg.com', 'prnewswire.com']).

## `exclude_domains` (type: `array`):

Domains to ignore or omit from search results (e.g. \['reddit.com', 'pinterest.com']).

## `max_items_per_competitor` (type: `integer`):

Maximum number of signals to extract per competitor (1 to 15).

## Actor input object example

```json
{
  "competitors": [
    "Shopify",
    "BigCommerce"
  ],
  "tracking_category": "all",
  "time_range": "week",
  "include_domains": [],
  "exclude_domains": [],
  "max_items_per_competitor": 5
}
```

# Actor output Schema

## `overview` (type: `string`):

Link to time-filtered competitor pricing and news records

# 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 = {
    "competitors": [
        "Shopify",
        "BigCommerce"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("song921619730/tavily-competitor-news-radar").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 = { "competitors": [
        "Shopify",
        "BigCommerce",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("song921619730/tavily-competitor-news-radar").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 '{
  "competitors": [
    "Shopify",
    "BigCommerce"
  ]
}' |
apify call song921619730/tavily-competitor-news-radar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,song921619730/tavily-competitor-news-radar"
        }
    }
}
```

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/whVZu3Z0teY7KvlxT/builds/tSV3xQ3IGHENb736P/openapi.json