Free News API

https://freenewsapi.io/docs

Admin

Free News API provides authenticated access to news articles, publisher and author information, with...

Tokens:775

Snippets:9

Trust Score:3.1

Update:5 months ago

Show doc for...

Tokens:

Raw

### Make a Request to the News Endpoint

Source: https://freenewsapi.io/docs/index.php

Example of how to make a GET request to the /news endpoint using curl. Ensure you replace 'YOUR_API_KEY' with your actual API key.

```shell
curl "https://api.freenewsapi.io/v1/news?language=en&country=us" -H "x-api-key: YOUR_API_KEY"
```

--------------------------------

### List News Articles

Source: https://freenewsapi.io/docs/index.php

Retrieves a list of news articles. Supports various query parameters for filtering and pagination.

```APIDOC
## GET /news

### Description
List news articles.

### Method
GET

### Endpoint
https://api.freenewsapi.io/v1/news

### Query Parameters
- **published_after** (string) - Optional - Filter news published after a specific date.
- **published_before** (string) - Optional - Filter news published before a specific date.
- **language** (string) - Optional - Filter by language (e.g., 'en').
- **country** (string) - Optional - Filter by country (e.g., 'us').
- **topic** (string) - Optional - Filter by topic (e.g., 'world').
- **publisher_uuid** (string) - Optional - Filter by publisher UUID.
- **author_uuid** (string) - Optional - Filter by author UUID.
- **q** (string) - Optional - Broad search query across title, subtitle, and content.
- **in_title** (string) - Optional - Search only within the title.
- **in_subtitle** (string) - Optional - Search only within the subtitle.
- **in_body** (string) - Optional - Search only within the full article text.
- **order_by** (string) - Optional - Order of results (e.g., 'recent').
- **offset** (integer) - Optional - Offset for pagination.
- **cursor** (string) - Optional - Cursor for cursor-based pagination.

### Request Example
```curl
curl "https://api.freenewsapi.io/v1/news?language=en&country=us" -H "x-api-key: YOUR_API_KEY"
```

### Response
#### Success Response (200)
- **field1** (type) - Description (Details about the response structure are not provided in the source.)
```

Tokens:

Raw