DOCUMENTATION

Build with News Search API

One REST API for searching and reading news from publishers worldwide. JSON over HTTPS, a predictable envelope, and plain-English errors.

Try it now. No key needed.

GET /v1/headlines/sample is public, so you can see real output before you sign up. Paste this into a terminal:

curl "https://apis.newssearchapi.com/v1/headlines/sample"

const response = await fetch("https://apis.newssearchapi.com/v1/headlines/sample");
const data = await response.json();

import os
import requests

response = requests.get(
    "https://apis.newssearchapi.com/v1/headlines/sample",
)
data = response.json()

req, _ := http.NewRequest(
    "GET",
    "https://apis.newssearchapi.com/v1/headlines/sample",
    nil,
)
resp, err := http.DefaultClient.Do(req)

$response = file_get_contents(
    "https://apis.newssearchapi.com/v1/headlines/sample"
);
$data = json_decode($response, true);

Ready for the full API? Create a free key. No card required; see Plans for the credits it includes.

The basics

Base URL: https://apis.newssearchapi.com
Authentication: X-Api-Key: <your key> header. More options
Format: JSON. Success responses have "status": "ok".
Errors: Stable code, readable message and a requestId. All codes
Versioning: The version is in the path (/v1). Breaking changes are announced in the changelog first.
CORS: Enabled for GET, but keep keys on your server, not in browser code.

Start here

Endpoints

Build with AI

Getting help

Include the requestId from the error body (or the X-Request-Id header) when you email developer support, so we can find the exact request. Check API status if requests start failing unexpectedly.

Stuck or found a mistake?Email developer support