# Introduction

The News API delivers articles from news sites as structured JSON - from major global outlets to local publications.

## Endpoint

`GET`

```bash
https://api.webz.io/api/news
```

## Example

Track English coverage of a company:

```bash
https://api.webz.io/api/news?token=YOUR_TOKEN&q=organization:"nvidia" language:english
```

## What stands out in news posts

Beyond the [standard post fields](news-api-post-fields), news content makes the most of:

| Field | Meaning |
| --- | --- |
| `trust` | Source trust metadata: `bias`, `categories`, and `source` details such as `type` and location |
| `breaking` | `true` while a story is breaking |
| `syndication` | Whether the article is a syndicated copy, and the id of its syndication cluster |
| `sentiment` | Post-level sentiment |
| `entities` | People, organizations, and locations mentioned, each with its own sentiment |
| `thread.domain_rank` | Rank of the publishing domain |
| `thread.licensing_agency` | Licensing agencies for the content |
| `thread.social` | Facebook likes, shares, and comments, plus VK shares |
| `thread.performance_score` | Engagement score of the thread |

Filter on them directly, e.g. `domain_rank:<1000` for top-ranked sites, `sentiment:negative` for critical coverage, or `performance_score:>5` for high engagement - see [Filters](news-api-filters). Sort by any social metric (`social.facebook.shares`, `social.facebook.likes`, and more) to surface what resonates - see [Request Parameters](news-blogs-forums-parameters).

> [!NOTE]
> Syndicated copies of articles are excluded by default. Add `includeSyndicated=true` to get them - see [Request Parameters](news-blogs-forums-parameters).

## Coverage window

News content is searchable for the **last 31 days**; with `allowNewsHistory=true` news history reaches back about a year - see [Time Range & History](news-blogs-forums-time-range). Older data - up to the last **5 years** - is available via the [News, Blogs, Forums & Reviews Archive](archive-what-is).