Get one article

Returns a single article by the stored id returned from /v1/articles. IDs are signed 64-bit decimal strings (migrated from the URL fingerprint), so they may be negative. Accepts no query parameters other than apiKey. Any article still available in the data store can be retrieved.

GEThttps://apis.newssearchapi.com/v1/articles/{id}API key

Parameters

idstringpathRequired
Example
-4210765838120375291

Response 200 · application/json

The article.

statusstringalways
articleobjectalways
Show 18 child fields
- idstring
  Stable stored article id.
- titlestring
- descriptionstring | null
- contentstring
  Plain-text excerpt of the article body (every plan). Markdown links become link text and images are omitted; stored HTML is converted to text. Paragraphs are separated by blank lines. The excerpt is about 200 characters, ending at a sentence or paragraph boundary when possible, otherwise at a word boundary, followed by an ellipsis. Full article text is not returned.
- contentTruncatedboolean
  True when content is an excerpt ending with an ellipsis, which is the case on every plan.
- urlstring
- imageUrlstring | null
- authorstring | null
- publishedAtstring
  RFC 3339, UTC, second precision.
- languagestring | null
  ISO 639-1 code (lowercase first two letters of the article locale).
- countrystring | null
  Lowercase country code.
- regionstring | null
- categoriesstring[]
  May be empty.
- sourceobject
  Publisher display name and website hostname; internal site IDs are never exposed.
  Show 2 child fields
  - namestring
  - domainstring
- indexedAtstring | null
  Time this article version was last indexed; use with indexed_from for incremental sync.
- storyIdstring | null
  Dedupe story identifier.
- trustScorenumber | null
  Article trust score.
- corroboratedByinteger
  Number of corroborating publishers.

Errors

Every error uses the same envelope with a stable code. See error handling for which ones to retry.

400Invalid parameter after authentication; no credits are charged.
401Missing (`apiKeyMissing`) or invalid (`apiKeyInvalid`) API key.
402Sharedstack could not reserve the maximum charge for this article request (`insufficientCredits`). `X-Credits-Remaining` is `unknown` if Stack does not return a balance.
403No active sharedstack plan or subscription; no credits are charged. Revoked-key responses may omit these headers.
404No article with this id (`notFound`).
405Only GET, HEAD and OPTIONS are supported (`methodNotAllowed`).
429The uniform gateway rate limit was exceeded; no credits are charged.
500Unexpected server error after authentication; no credits are charged.
503Dependency unavailable after authentication; no credits are charged.

curl "https://apis.newssearchapi.com/v1/articles/-4210765838120375291" \
  -H "X-Api-Key: $API_KEY"

const response = await fetch("https://apis.newssearchapi.com/v1/articles/-4210765838120375291", {
  headers: { "X-Api-Key": process.env.API_KEY },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://apis.newssearchapi.com/v1/articles/-4210765838120375291",
    headers={"X-Api-Key": os.environ["API_KEY"]},
)
data = response.json()

req, _ := http.NewRequest(
    "GET",
    "https://apis.newssearchapi.com/v1/articles/-4210765838120375291",
    nil,
)
req.Header.Set("X-Api-Key", os.Getenv("API_KEY"))
resp, err := http.DefaultClient.Do(req)

$context = stream_context_create([
    "http" => ["header" => "X-Api-Key: " . getenv("API_KEY")],
]);
$response = file_get_contents(
    "https://apis.newssearchapi.com/v1/articles/-4210765838120375291",
    false,
    $context
);
$data = json_decode($response, true);

Try it

Uses your key

GET/v1/articles/{id}

Example response · 200

{
  "status": "ok",
  "article": {
    "id": "-4210765838120375291",
    "title": "Central bank holds rates steady amid cooling inflation",
    "description": "Policymakers voted 7–2 to keep the benchmark rate unchanged.",
    "content": "Policymakers voted 7–2 on Thursday to keep the benchmark rate unchanged, citing a steady decline in core inflation over the past quarter. The decision was widely expected by markets. …",
    "contentTruncated": true,
    "url": "https://www.dailyledger.example/business/rates-hold",
    "imageUrl": "https://cdn.dailyledger.example/img/rates.jpg",
    "author": "Jane Smith",
    "publishedAt": "2026-10-31T09:15:00Z",
    "language": "en",
    "country": "gb",
    "region": "Europe",
    "categories": [
      "business",
      "economy"
    ],
    "source": {
      "name": "The Daily Ledger",
      "domain": "dailyledger.example"
    },
    "indexedAt": "2026-10-31T09:15:02Z",
    "storyId": "story-2026-10-31-001",
    "trustScore": 0.94,
    "corroboratedBy": 8
  }
}

Stuck or found a mistake?Email developer support