← APIs / NewsAPI
Verified

NewsAPI

Apiosk Basicsby Apiosk Basics · General

Worldwide news from 80k+ sources: breaking top headlines and a full-text article search across the web.

mediaapi
Price per request
$0.07
About

NewsAPI aggregates headlines and articles from 80,000+ sources and blogs worldwide. This listing proxies it through the Apiosk gateway with pay-per-call billing; the API key is injected by the gateway. Fetch breaking top headlines by country/category, or run a full-text search across every indexed article.

Base URL
https://gateway.apiosk.com/newsapi
Technical Specs
Auth MethodapiKey
Response FormatJSON
Endpoints2
Endpoints
MethodPathDescriptionCost
GET /everything Full-text search across every article NewsAPI indexes, sortable by relevance/date and filterable by source, language and date range.
$0.07 default
View details
GET /top-headlines Breaking headlines, filterable by country, category, source or keyword. Returns each article's title, source, author, description, URL, image and publish time.
$0.07 default
View details
Endpoint documentation
GET/everything
$0.07 default
Description

Full-text search across every article NewsAPI indexes, sortable by relevance/date and filterable by source, language and date range.

Pricing
$0.07 default
Parameters
{
  "language": {
    "description": "2-letter language code.",
    "example": "en",
    "required": false,
    "type": "string"
  },
  "pageSize": {
    "description": "Results per page (max 100).",
    "example": "20",
    "required": false,
    "type": "integer"
  },
  "q": {
    "description": "Keywords or phrase to search for.",
    "example": "bitcoin",
    "required": true,
    "type": "string"
  },
  "sortBy": {
    "description": "relevancy, popularity or publishedAt.",
    "example": "publishedAt",
    "required": false,
    "type": "string"
  }
}
Response schema
{
  "properties": {
    "articles": {
      "items": {
        "properties": {
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "content": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "publishedAt": {
            "type": "string"
          },
          "source": {
            "type": "object"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "status": {
      "type": "string"
    },
    "totalResults": {
      "type": "integer"
    }
  },
  "type": "object"
}
Example response
{
  "articles": [
    {
      "author": "Matt Novak",
      "content": "Bitcoin climbed…",
      "description": "The cryptocurrency rallied on…",
      "publishedAt": "2026-07-02T09:12:00Z",
      "source": {
        "id": null,
        "name": "Gizmodo.com"
      },
      "title": "Bitcoin Surges Past New High",
      "url": "https://gizmodo.com/…"
    }
  ],
  "status": "ok",
  "totalResults": 10452
}
GET/top-headlines
$0.07 default
Description

Breaking headlines, filterable by country, category, source or keyword. Returns each article's title, source, author, description, URL, image and publish time.

Pricing
$0.07 default
Parameters
{
  "category": {
    "description": "business, entertainment, general, health, science, sports, technology.",
    "example": "technology",
    "required": false,
    "type": "string"
  },
  "country": {
    "description": "2-letter country code.",
    "example": "us",
    "required": false,
    "type": "string"
  },
  "pageSize": {
    "description": "Results per page (max 100).",
    "example": "20",
    "required": false,
    "type": "integer"
  },
  "q": {
    "description": "Keywords to search headlines for.",
    "example": "tech",
    "required": false,
    "type": "string"
  }
}
Response schema
{
  "properties": {
    "articles": {
      "items": {
        "properties": {
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "content": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "publishedAt": {
            "type": "string"
          },
          "source": {
            "properties": {
              "id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "name": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "urlToImage": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "status": {
      "type": "string"
    },
    "totalResults": {
      "type": "integer"
    }
  },
  "type": "object"
}
Example response
{
  "articles": [
    {
      "author": "Jason Schreier",
      "content": "Microsoft Corp.'s Xbox has pulled out of a deal…",
      "description": "The makers had teamed up with Xbox for the new video game",
      "publishedAt": "2026-06-30T17:49:32Z",
      "source": {
        "id": "bloomberg",
        "name": "Bloomberg"
      },
      "title": "Microsoft's Xbox Pulls Out of Project Fantasy Video Game",
      "url": "https://www.bloomberg.com/news/articles/2026-06-30/...",
      "urlToImage": "https://assets.bwbx.io/images/...1200x655.jpg"
    }
  ],
  "status": "ok",
  "totalResults": 69
}