News Articles API

Endpoint

GET /v1/news/articles

Parameters

query *

Search keyword (max 500 characters)

limit

Number of results to return, 1-100 (default: 10)

time_published

Time filter: anytime, 1h, 1d, 7d, 1m, 1y (default: anytime)

source

Filter by news source (e.g., bbc.com)

country

2-letter country code (default: us)

language

2-letter language code (default: en)

Response fields

articles

Array of matching news articles

title

Article headline

url

Direct link to the article

snippet

Article content preview

photo_url

Article photo URL

thumbnail_url

Article thumbnail URL

published_datetime_utc

Publication date and time in UTC

authors

List of author names

source_url

News source URL

source_name

News source name

source_favicon_url

News source favicon URL

domain

Article domain name

limit

Requested result limit

count

Number of results returned

Example Request

curl "https://apidirect.io/v1/news/articles?query=artificial%20intelligence&limit=10&time_published=1d&country=us&language=en" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/news/articles",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "artificial intelligence",
        "limit": 10,
        "time_published": "1d",
        "country": "us",
        "language": "en"
    }
)
print(response.json())

Example Response

{
  "articles": [
    {
      "title": "New AI Breakthrough Changes the Industry",
      "url": "https://example.com/article/ai-breakthrough",
      "snippet": "Researchers have announced a major advancement in artificial intelligence...",
      "photo_url": "https://example.com/images/ai-photo.jpg",
      "thumbnail_url": "https://example.com/images/ai-thumb.jpg",
      "published_datetime_utc": "2025-01-15 14:30:00",
      "authors": ["Jane Smith", "John Doe"],
      "source_url": "https://example.com",
      "source_name": "Example News",
      "source_favicon_url": "https://example.com/favicon.ico",
      "domain": "example.com"
    }
  ],
  "limit": 10,
  "count": 1
}

Frequently asked questions

How fresh is the news data?

The News Articles API provides near real-time data. Use the time_published parameter to filter by recency: 1h for the last hour, 1d for the last day, 7d for the last week, 1m for the last month, or 1y for the last year.

Can I filter by a specific news source?

Yes, use the source parameter to filter results to a specific news source domain (e.g., source=bbc.com). This is useful for monitoring coverage from a particular publisher.

What countries and languages are supported?

The API supports dozens of countries and languages. Use standard 2-letter ISO codes for the country parameter (e.g., us, gb, de) and language parameter (e.g., en, es, fr).

What is the maximum number of results I can get?

You can request up to 100 results per request using the limit parameter. The default is 10 results if no limit is specified.

How does pricing work?

You only pay for successful requests. The News Articles API costs $0.008 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.