---
title: "News"
description: "News articles from around the web whose headline or named people and organisations include your keyword."
canonical: https://docs.mentio.dev/platforms/news
markdown: https://docs.mentio.dev/platforms/news.mdx
---

# News

News articles from around the web whose headline or named people and organisations include your keyword.

Mentio reads the GDELT news feed, every English-language article it sees worldwide, every 15 minutes, and keeps those that name a keyword.

| `platform`                    | `news`                                            |
| ----------------------------- | ------------------------------------------------- |
| What is found                 | English-language news articles                    |
| Freshness                     | About every 15 minutes                            |
| Last 30 days on a new keyword | No: news is read from the moment a keyword starts |

## Track it [#track-it]

Create a keyword limited to News. Leave `platforms` out to search every platform.

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/keywords', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "term": "Acme",
    "kind": "brand",
    "platforms": [
      "news"
    ]
  }),
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.post(
    "https://api.mentio.dev/v1/keywords",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
    json={
      "term": "Acme",
      "kind": "brand",
      "platforms": [
        "news"
      ]
    },
)
print(response.json())
```

cURL:

```bash
curl -X POST "https://api.mentio.dev/v1/keywords" \
  -H "Authorization: Bearer $MENTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "term": "Acme",
  "kind": "brand",
  "platforms": [
    "news"
  ]
}'
```

## Read its mentions [#read-its-mentions]

Filter the mentions list to News. `range=7d` keeps the last seven days.

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/mentions?platforms=news&range=7d', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
  },
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.get(
    "https://api.mentio.dev/v1/mentions?platforms=news&range=7d",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
)
print(response.json())
```

cURL:

```bash
curl -X GET "https://api.mentio.dev/v1/mentions?platforms=news&range=7d" \
  -H "Authorization: Bearer $MENTIO_API_KEY"
```

Response (trimmed):

```json
{
  "data": [
    {
      "id": "mm_8f2k1x9q",
      "status": "open",
      "relevant": true,
      "keyword": {
        "id": "kw_123",
        "term": "Acme"
      },
      "post": {
        "publishedAt": "2026-11-07T14:32:10.000Z",
        "platform": "news",
        "kind": "post",
        "url": "https://techcrunch.com/2026/11/05/acme-raises-series-a/",
        "title": "Acme raises a $12M Series A",
        "text": "Acme raises a $12M Series A. Named: Acme, Jane Smith. techcrunch.com"
      },
      "author": {
        "name": "techcrunch.com",
        "handle": "techcrunch.com",
        "url": "https://techcrunch.com"
      },
      "classification": {
        "relevance": 82,
        "sentiment": "positive",
        "intents": [
          "praise"
        ],
        "note": "A user recommends Acme by name."
      }
    }
  ],
  "nextCursor": "eyJ0IjoxNzMxMDAwMDAwfQ"
}
```

## What a mention carries [#what-a-mention-carries]

* `post.text`: the headline, the people and organisations the article names, and the site.
* `author`: the site (its domain and link).

The rest is the same on every platform: relevance, sentiment and intent from the classifier, your triage, and the keyword it matched. See the [mention shape](/api).

## Mute an author [#mute-an-author]

The site's address, such as `techcrunch.com`: it mutes that publication. See [Mute authors](/alerts#mute-authors).

## Limits [#limits]

* The article's body is not read: a keyword named only in the body, and not among the article's named people and organisations, is missed.
* English-language articles only.