The News API · Schema

The News API Article

A news article as returned by The News API.

ArticlesHeadlinesNewsMediaSearchInternational

Properties

Name	Type	Description
uuid	string	Unique identifier for the article.
title	string	Article headline.
description	string	Short description or summary of the article.
keywords	string	Comma-separated keywords associated with the article.
snippet	string	Short excerpt from the article body.
url	string	URL to the full article on the publisher's website.
image_url	string	URL to the article's featured image.
language	string	Language code of the article (ISO 639-1, e.g., en, es, fr).
published_at	string	Publication datetime in UTC (ISO 8601 format).
source	string	Domain name of the publishing source (e.g., cnn.com).
categories	array	Categories the article belongs to.
locale	string	Country/locale code where the article is primarily relevant (e.g., us, gb, ca).
relevance_score	number	Relevance score for search results (higher = more relevant). Null for non-search endpoints.
similar	array	Similar articles (only present in headlines response).

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/the-news-api/main/json-schema/the-news-api-article-schema.json",
  "title": "The News API Article",
  "description": "A news article as returned by The News API.",
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Unique identifier for the article."
    },
    "title": {
      "type": "string",
      "description": "Article headline."
    },
    "description": {
      "type": "string",
      "description": "Short description or summary of the article."
    },
    "keywords": {
      "type": "string",
      "description": "Comma-separated keywords associated with the article."
    },
    "snippet": {
      "type": "string",
      "description": "Short excerpt from the article body."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "URL to the full article on the publisher's website."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "URL to the article's featured image.",
      "nullable": true
    },
    "language": {
      "type": "string",
      "description": "Language code of the article (ISO 639-1, e.g., en, es, fr).",
      "pattern": "^[a-z]{2}$"
    },
    "published_at": {
      "type": "string",
      "format": "date-time",
      "description": "Publication datetime in UTC (ISO 8601 format)."
    },
    "source": {
      "type": "string",
      "description": "Domain name of the publishing source (e.g., cnn.com)."
    },
    "categories": {
      "type": "array",
      "description": "Categories the article belongs to.",
      "items": {
        "type": "string",
        "enum": [
          "general",
          "business",
          "sports",
          "tech",
          "science",
          "health",
          "entertainment",
          "politics",
          "food",
          "travel"
        ]
      }
    },
    "locale": {
      "type": "string",
      "description": "Country/locale code where the article is primarily relevant (e.g., us, gb, ca)."
    },
    "relevance_score": {
      "type": "number",
      "nullable": true,
      "description": "Relevance score for search results (higher = more relevant). Null for non-search endpoints."
    },
    "similar": {
      "type": "array",
      "description": "Similar articles (only present in headlines response).",
      "items": {
        "$ref": "#"
      }
    }
  },
  "required": ["uuid", "title", "url", "published_at", "source"],
  "additionalProperties": false
}