# News Mentions API: Brand & Keyword Monitoring

The News Mentions API searches a curated index of publisher news feeds and returns one row per article: headline, a snippet of up to 320 characters, the publisher's own article URL, publisher name and domain, region, topic, language, publish time and every keyword that matched. Queries support AND, exact phrases, OR and exclusions, with filters for region, topic, language, domain and date. Articles cost $1.00 per 1,000. Run it from Apify Console or the API.

## Key facts

- Price: from $0.001 per article, $1.00 per 1,000
- Pricing model: Pay per event
- Output: JSON, CSV, Excel, XML, RSS via Apify datasets
- Access: Apify Console, REST API, Python and JS clients, MCP tool news_mentions
- Version: Updated Nov 2026, build 0.1.2
- Usage: 100.0% successful runs (30 days)
- Actor: subimpact/news-mentions-api

## Who it is for

- PR and comms teams tracking company and executive mentions
- Competitive intelligence analysts watching what the local press says
- Agencies feeding a client dashboard or alerting pipeline with fresh links
- Analysts who need Malaysian and Southeast Asian coverage without building a crawler

## Use cases

### Track a brand across publishers

Put your terms in keywords, for example Petronas, and set regions to MY with topics business and energy. Each row carries title, snippet, url and publishedAt, with sourceName and sourceDomain naming the publisher. Because the url is the publisher's own link rather than an aggregator redirect, a mention can be cited straight from the row.

### Filter noise once for every query

Put recurring junk in excludeKeywords, such as press release and advertorial. Each entry is appended to every query as a negative term, with multi-word terms quoted automatically. That keeps one exclusion list instead of editing a dozen queries, and a query made only of exclusions is rejected so a run cannot silently match nothing.

### Run an hourly mention monitor

Turn on onlyNew with the first run returning your lookbackDays window, then each later run returns only articles added since. The cursor lives in the news-mentions-state key-value store and only advances when a run finishes cleanly, so an interrupted run repeats those articles rather than losing them.

### Compare what two markets are saying

Run the same keyword list twice, once with regions MY and once with SG, and compare the counts, topics and publishers. matchedKeywords shows which of your queries hit, and topic splits business from tech, auto and crypto, so a market comparison does not depend on reading every headline by hand.

### Feed a dashboard or an LLM store

Rows carry stable articleId values, firstSeenAt for ingest order and imageUrl where the feed has one. That is enough to upsert into a news table or a RAG store without duplicates, and delta mode means a scheduled job adds only new links. snippet is capped at 320 characters and full article text is never returned.

## Price events

- Article (`article`): $0.001, lowest tier $0.001. One news article row delivered (headline, snippet, publisher link, source, date).

Prices from the Apify Store. Apify shows the final price before each run.

## How it compares with other Apify actors

Price per 1,000 articles at Apify Store list prices, checked 20 Nov 2026.

| Actor | Price per 1,000 articles (Free plan) | Higher plans (Gold) | Start fee per run | Platform usage | Users | Rating | Last build |
| --- | --- | --- | --- | --- | --- | --- | --- |
| News Mentions API: Brand & Keyword Monitoring (this API) | $1.00 | $1.00 | None | Paid separately | 1 | No reviews yet | 18 Nov 2026 |
| [Google News Scraper](https://apify.com/lhotanova/google-news-scraper) | $2.00 | $1.30 | $0.005 | Included | 3,773 | 4.4 (12 reviews) | 12 Nov 2026 |
| [Google News Scraper](https://apify.com/automation-lab/google-news-scraper) | $2.30 | $1.20 | None | Included | 923 | No reviews yet | 20 Nov 2026 |
| [Google News Scraper for Monitoring & Alerts](https://apify.com/andok/google-news-scraper) | $1.00 | $0.467 | $0.01 | Included | 116 | No reviews yet | 30 Jul 2026 |

### Where Google News Scraper is stronger

- Can resolve Google News redirects to real publisher URLs
- Can load the article page for extra data such as the image
- Covers topics and date ranges beyond Google's default result cap

### Where this API is stronger

- Publisher URLs arrive as rows, with no separate resolution event
- One row per article, with matchedKeywords showing every keyword it hit
- Rows carry region, topic, language and publisher domain

### Where Google News Scraper is stronger

- Supports topic and country filters for different Google News editions
- Returns description and query fields beside each article
- Larger user base and more recent runs than ours

### Where this API is stronger

- Rows carry region, topic and language without choosing a Google edition
- onlyNew returns just the articles seen since the previous run
- Dedupe across keywords means one row per article, not one per keyword

### Where Google News Scraper for Monitoring & Alerts is stronger

- Output is light and RSS backed, quick to schedule for alerts
- Small input covering queries, maximum articles and language

### Where this API is stronger

- Output adds publisher domain, region, topic and first seen time
- Keyword and domain exclusions are part of the input
- Dedupe across keywords and a cursor based new article mode

All of these actors return news rows for brand and keyword monitoring, and the Google News based ones can also resolve redirect links or load article pages. This actor comes at the same job from publisher feeds, so publisher URLs and source metadata are present from the start. The trade is that Google News editions and topic tabs are not part of its input.

Prices are Apify Store list prices, checked 20 Nov 2026. Platform usage 'Paid separately' means Apify bills compute on top of the event price. Check each listing before you buy.

## Input

- `keywords` (array, required): 1–100 search queries. Defaults to a demo query when omitted. Query syntax: words are ANDed by default (petronas profit = both words); "exact phrase" in double quotes; OR between terms (uppercase); -term or -"phrase" excludes. Example: Pe...
- `excludeKeywords` (array, optional): Appended to every query as -term, so you can filter noise once instead of in each keyword. Multi-word terms are quoted automatically: "press release" becomes -"press release".
- `regions` (array, optional): Publisher regions to search. Leave empty for all regions. MY = Malaysia, SG = Singapore, ID = Indonesia, PH = Philippines, TH = Thailand, VN = Vietnam, GLOBAL = international outlets.
- `topics` (array, optional): Publisher sections to search. Leave empty for all topics.
- `languages` (array, optional): ISO language codes of the publisher feed, e.g. en, ms, id, th, vi. Leave empty for all languages.
- `domains` (array, optional): Restrict results to these publisher domains (subdomains included): thestar.com.my also matches biz.thestar.com.my. Leave empty for any publisher.
- `excludeDomains` (array, optional): Drop results from these publisher domains (subdomains included).
- `lookbackDays` (integer, optional): How many days back to search, counted from now (1–180). The index keeps up to 180 days of history. Ignored when dateFrom is set, and on scheduled delta runs (onlyNew) after the first run.
- `dateFrom` (string, optional): Only articles published on/after this date. ISO format: 2026-10-01 or 2026-10-01T09:00:00Z.
- `dateTo` (string, optional): Only articles published on/before this date (inclusive; a bare date covers the whole day). ISO format: 2026-10-24 or 2026-10-24T18:00:00Z.
- `maxItemsPerKeyword` (integer, optional): Upper limit of articles fetched for each keyword (1–5000). You are charged only for the articles actually returned.
- `dedupeAcrossKeywords` (boolean, optional): On (default): an article matching several keywords appears once, with every matching keyword in matchedKeywords. Off: one row per keyword match, pushed as soon as it is fetched.
- `onlyNew` (boolean, optional): For scheduled monitoring: remembers how far the index it has been read (in the named key-value store news-mentions-state) and returns only articles added since. The first run returns the lookback window. Do not mix delta and full runs in...
- `stateKey` (string, optional): Only for onlyNew. Name of the stored cursor. Leave empty to derive it from the query (keywords + filters), so different searches keep separate cursors in the same task.

### Example input

```json
{
  "keywords": [
    "Petronas",
    "\"electric vehicle\" Malaysia"
  ],
  "regions": [
    "MY"
  ],
  "lookbackDays": 7,
  "maxItemsPerKeyword": 100
}
```

## Output fields

- `keyword` (string/null): The first input keyword that matched this article
- `matchedKeywords` (array): Every input keyword that matched this article, in input order (dedupeAcrossKeywords on)
- `title` (string/null): Article headline from the publisher feed
- `snippet` (string/null): Plain-text summary from the feed, HTML stripped, max 320 characters (never the full article text)
- `url` (string/null): Publisher article link (not an aggregator redirect)
- `sourceName` (string/null): Publisher name, e.g. The Star
- `sourceDomain` (string/null): Registrable publisher domain, e.g. thestar.com.my
- `region` (string/null): Publisher region: MY, SG, ID, PH, TH, VN or GLOBAL
- `topic` (string/null): Publisher section: general, business, tech, startups, auto, finance, crypto, marketing, ecommerce, energy
- `language` (string/null): Feed language code, e.g. en, ms, id, th, vi
- `publishedAt` (string/null): Publication time, ISO 8601 UTC
- `firstSeenAt` (string/null): When the index first ingested this article, ISO 8601 UTC
- `imageUrl` (string/null): Lead image URL from the feed, when present
- `author` (string/null): Article author / byline from the feed, when present
- `matchedIn` (array): Which fields contained a query term: title and/or snippet
- `articleId` (string/null): Stable article id (16 hex chars, sha1 of the canonical URL)

## Sample output

Trimmed from one of our own test runs. Personal data is redacted.

```json
[
  {
    "keyword": "Malaysia OR Singapore OR Indonesia",
    "matchedKeywords": [
      "Malaysia OR Singapore OR Indonesia"
    ],
    "title": "Jualan Proton X90 Meningkat 82.5 Peratus - Kekal SUV Segmen-D No.1 Di Malaysia!",
    "snippet": "Peningkatan ini dilihat sebagai perkembangan positif buat model SUV utama PROTON itu selepas berdepan keadaan pasaran yang agak mencabar pada tahun lalu. Antara faktor yang menyumbang kepada prestasi tersebut ialah penambahbaikan yang di...",
    "url": "https://careta.my/article/jualan-proton-x90-meningkat-825-peratus-kekal-suv-segmen-d-no1-di-malaysia",
    "sourceName": "Careta",
    "sourceDomain": "careta.my",
    "region": "MY",
    "topic": "auto",
    "language": "en",
    "publishedAt": "2026-11-20T03:31:31Z",
    "firstSeenAt": "2026-11-20T03:33:57Z",
    "imageUrl": null,
    "author": "firdaus",
    "matchedIn": [
      "title"
    ],
    "articleId": "9506abbf817978e6"
  },
  {
    "keyword": "Malaysia OR Singapore OR Indonesia",
    "matchedKeywords": [
      "Malaysia OR Singapore OR Indonesia"
    ],
    "title": "BPC Pairs SmartVista with Huawei for Payment Modernisation",
    "snippet": "BPC and Huawei Technologies have launched a solution partnership to modernise payment infrastructure for financial institutions. The companies unveiled the deal at the Singapore Fintech Festival 2026 and plan to target financial institut...",
    "url": "https://fintechnews.sg/141993/payments/bpc-huawei-payments-partnership-sff-2026/",
    "sourceName": "Fintech News Singapore",
    "sourceDomain": "fintechnews.sg",
    "region": "SG",
    "topic": "finance",
    "language": "en",
    "publishedAt": "2026-11-20T02:33:08Z",
    "firstSeenAt": "2026-11-20T02:38:24Z",
    "imageUrl": "https://fintechnewssg-22e90.kxcdn.com/wp-content/uploads/2026/11/ZX-LI-150x150.jpg",
    "author": "Fintech News Singapore",
    "matchedIn": [
      "snippet"
    ],
    "articleId": "92d449014aee87d8"
  }
]
```

## How to run it

1. List queries in keywords, for example Petronas, "electric vehicle" Malaysia or Grab OR foodpanda -promo.
2. Pick regions such as MY and SG, topics such as business, and optional languages, domains or excludeDomains.
3. Set lookbackDays, for example 30, or use dateFrom and dateTo for an exact window, and cap results with maxItemsPerKeyword.
4. Leave dedupeAcrossKeywords on so an article matching several queries appears once with every match recorded.
5. Run the actor, then export the article rows as JSON, CSV or Excel, or read them through the Apify API.

### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/subimpact~news-mentions-api/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["Petronas","\"electric vehicle\" Malaysia"],"regions":["MY"],"lookbackDays":7,"maxItemsPerKeyword":100}'
```

### Python

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("subimpact/news-mentions-api").call(run_input={
      "keywords": [
        "Petronas",
        "\"electric vehicle\" Malaysia"
      ],
      "regions": [
        "MY"
      ],
      "lookbackDays": 7,
      "maxItemsPerKeyword": 100
    })

for item in client.dataset(run["default_dataset_id"]).iterate_items():
    print(item)
```

### JavaScript

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('subimpact/news-mentions-api').call({
  "keywords": [
    "Petronas",
    "\"electric vehicle\" Malaysia"
  ],
  "regions": [
    "MY"
  ],
  "lookbackDays": 7,
  "maxItemsPerKeyword": 100
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);
```

### MCP

```bash
claude mcp add subimpact-data -e APIFY_TOKEN=<YOUR_APIFY_TOKEN> -- npx -y @subimpact/data-mcp

# Then ask your agent to use the news_mentions tool.
```

### n8n

Use the Apify node (Run an Actor).
Actor ID: subimpact/news-mentions-api
Input JSON: paste the example input below.

## Limits

- Headline, snippet and link only, with no full article text.
- Coverage is a curated publisher list, not the whole web.
- Matching runs on the headline and feed summary, so body-only mentions can be missed.
- At most 100 queries per run, 5,000 articles per query and 180 days of history.

## FAQ

### What does an article cost?

Each delivered article costs $0.001, which is $1.00 per 1,000 articles. A search that returns nothing costs nothing, and an unavailable index fails the run before any row is pushed or charged. Platform compute is billed separately by Apify and is small for this actor.

### Do I need a news API key?

No. The actor queries a preconfigured index of publisher feeds, so there is no key to obtain, no browser and no proxy per page. Coverage is the curated source list rather than the whole web, and new outlets are added on request.

### Which regions and topics are covered?

Malaysia, Singapore, Indonesia, the Philippines, Thailand and Vietnam, plus a GLOBAL layer of international outlets. Topics cover general, business, tech, startups, auto, finance, crypto, marketing, ecommerce and energy, and up to 180 days of history is kept.

### Do I get the full article text?

No. The index stores the headline, a snippet capped at 320 characters, and the publisher link. Read the body on the publisher's site if you need it. That design keeps the data linkable and avoids republishing content you have no rights to.

### Why is a mention I know about missing?

Matching runs on the headline and the feed summary only, so a mention buried in the article body can be missed. The publisher may also be outside the source list, or the article may sit outside your window. Widen the query or the lookback, and ask for the outlet to be added.

### How does delta mode avoid sending duplicates?

onlyNew stores how far the index has been read, per query, in the named key-value store. The cursor advances only after a clean finish, so an interrupted run repeats rather than drops articles. Changing a filter creates a new cursor and a fresh lookback window.

### How fresh is the index?

Publisher feeds are polled continuously, and each run's status message reports the last ingest time and lag. If the index reports degraded, results may be behind and the run says so, which lets a scheduled job alert on staleness instead of publishing quietly stale links.

## Links

- Page: https://subimpact.net/apis/news-mentions-api/
- Category: https://subimpact.net/apis/category/search-seo/
- Run on Apify: https://apify.com/subimpact/news-mentions-api
- All data APIs: https://subimpact.net/apis/
- Catalogue JSON: https://subimpact.net/apis/catalogue.json
