JSON Response

The API returns data in JSON format, for example as follows:

{
  "totalArticles": 54904,
  "articles": [
    {
      "id": "b961dade95c55b7f949ccd8e0234a356",
      "title": "M5 chip leak reveals Apple has big gains coming in key area",
      "description": "Apple’s forthcoming M5 chip has seemingly leaked as part of a new iPad Pro hardware leak. Here’s what its performance looks like in testing.",
      "content": "Today, Apple’s as-yet-unannounced M5 iPad Pro was seemingly leaked by the same YouTuber who last year leaked the M4 MacBook Pro. Thanks to the surprise reveal, we now have benchmarks for Apple’s forthcoming M5 chip, and they point to big gains coming... [1862 chars]",
      "url": "https://9to5mac.com/2025/09/30/m5-chip-leak-reveals-apple-has-big-gains-coming-in-key-area/",
      "image": "https://i0.wp.com/9to5mac.com/wp-content/uploads/sites/6/2024/12/M5-Pro-chip-could-separate-CPU-and-GPU-in-server-grade-chips.jpg?resize=1200%2C628&quality=82&strip=all&ssl=1",
      "publishedAt": "2025-09-30T19:38:25Z",
      "lang": "en",
      "source": {
        "id": "92f73865e835e33ed68c11447777c939",
        "name": "9to5Mac",
        "url": "https://9to5mac.com",
        "country": "us"
      }
    }
  ]
}

Properties

The response contains the following top-level properties:

Property	Description
totalArticles	Total number of articles matching your request. This is the size of the whole result set, not the number of articles returned: use the `max` parameter to control how many articles the response contains. Note that pagination is limited to the first 1000 articles.
articles	Array of the articles returned by the request.

Each article contains the following properties:

Property	Description
id	Unique identifier for the article.
title	Main title of the article.
description	Description of the article.
content	Full content of the article. For users on the Free plan, the full content is truncated. If you need to access the full content, you can upgrade your plan here: https://gnews.io/change-plan
url	URL of the article.
image	Main image of the article.
publishedAt	Date of publication of the article. The date is always in the UTC time zone.
lang	Language of the article.
source.id	Unique identifier for the source.
source.name	Name of the source.
source.url	Home page of the source.
source.country	Country in which the source is based. This attribute is only included in the response from the Search endpoint.

Properties​

Properties