News Search

POST

/api/v1/news

The news search endpoint indexes live, real-time news headlines, press releases, and global journal publications.

Results are updated continuously and include publisher names, article excerpts, publication timestamps, and direct story links.

Returned News Article Properties

Each item in the news response array contains structured editorial metadata:

title: Article headline or press story title
link: Canonical web URL to the published news article
snippet: Excerpt or opening sentences summarizing the story
publisher: Name of the publishing media outlet (e.g. "TechCrunch", "The Wall Street Journal")
date: Relative publication time (e.g. "10 hours ago", "1 day ago")
position: Numeric search engine rank position (1-based)

{
  "q": "artificial intelligence",
  "gl": "us",
  "hl": "en",
  "num": 10
}

Authorizations

X-API-KEYstringheaderrequired

Passed via request headers. Your secret API key for SerperMatrix (e.g. sm_live_...).

Body

application/json

qstringrequired

The news query terms or keywords (e.g. "artificial intelligence").

glstring

Country code for national news focus boundaries (e.g. "us").

hlstring

Language code for news content indexing (e.g. "en").

numintegerdefault: 10

Number of news articles to retrieve (min: 1, max limit: 100).

use_cachebooleandefault: true

Retrieve cached news results if available.

Request

curl -X POST https://serpermatrix.com/api/v1/news \
  -H "X-API-KEY: sm_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"artificial intelligence","num":2}'

{
  "searchParameters": {
    "q": "artificial intelligence",
    "num": 2,
    "type": "news"
  },
  "news": [
    {
      "title": "New LLM releases break speed and accuracy records on major leaderboards",
      "link": "https://example.com/ai-news",
      "snippet": "Latest benchmark results show significant gains in latency and accuracy.",
      "date": "2 days ago",
      "position": 1
    }
  ]
}