Get News

Retrieve latest sports news articles with source information

GET /news

Basketball News

cURL

curl --request GET \
  --url https://v1.basketball.sportsapipro.com/news \
  --header 'x-api-key: <api-key>'

Overview

Returns a list of the latest sports news articles from various sources, along with information about the news sources.

Cache TTL: This endpoint response is cached with a short TTL for fresh news content.

Parameters

sports · integer

Filter news by sport ID. Default: 1 (Football)

competitions · integer

Filter news by competition ID (e.g., 9 for Premier League)

games · integer

Filter news by specific game ID

isPreview · boolean

Whether to return preview/summary content. Default: true

limit · integer

Maximum number of news articles to return

Parameters appTypeId, langId, timezoneName, and userCountryId are automatically resolved by the upstream service. You can override timezoneName with a specific timezone (e.g., America/New_York). All publishDate fields use ISO 8601 format with a dynamic timezone offset.

Response Structure

news · array

Array of news article objects

Show News Article Object

id · integer

Unique news article identifier

publishDate · string

ISO 8601 timestamp of article publication (with timezone offset)

sourceId · integer

Reference ID to the news source in newsSources array

title · string

Article headline/title

image · string

URL to the article’s featured image

url · string

Full URL to read the article (includes UTM tracking parameters)

isMagazine · boolean

Whether article is editorial/magazine content

newsSources · array

Array of news source objects referenced by articles

Show News Source Object

id · integer

Unique source identifier (matches sourceId in news articles)

name · string

Display name of the news source

imageVersion · integer

Image asset version number for cache busting

Request Example

cURL

curl -X GET "https://v1.football.sportsapipro.com/news?sports=1&isPreview=true" \
  -H "x-api-key: YOUR_API_KEY"

Response Example

{
  "news": [
    {
      "id": 182133693,
      "publishDate": "2025-12-18T13:07:00+00:00",
      "sourceId": 2260,
      "title": "Crunch Time in the Conference League: Crystal Palace & The Fight for the Top 8",
      "image": "https://example.com/news/wp-content/uploads/2023/02/GettyImages-1244580595-1024x683.jpg",
      "url": "https://example.com/news/crunch-time-in-the-conference-league-crystal-palace-the-fight-for-the-top-8",
      "isMagazine": true
    },
    {
      "id": 182150817,
      "publishDate": "2025-12-18T13:05:50+00:00",
      "sourceId": 1463,
      "title": "Celtic board talks underway to sack Wilfried Nancy in new Parkhead bombshell",
      "image": "https://www.footballinsider247.com/static/uploads/1/2025/12/Wilfried-Nancy-Celtic-fans-1.jpg",
      "url": "https://www.footballinsider247.com/celtic-board-talks-underway-to-sack-wilfried-nancy-in-new-parkhead-bombshell/",
      "isMagazine": false
    },
    {
      "id": 182150840,
      "publishDate": "2025-12-18T13:02:14+00:00",
      "sourceId": 623,
      "title": "Man City target shock Enzo Maresca swoop if Pep Guardiola leaves next summer",
      "image": "https://i2-prod.mirror.co.uk/article36422287.ece/ALTERNATES/s1200/0_GettyImages-2165160879.jpg",
      "url": "https://www.mirror.co.uk/sport/football/news/chelsea-man-city-guardiola-maresca-36422315",
      "isMagazine": false
    }
  ],
  "newsSources": [
    {
      "id": 2260,
      "name": "SportsAPI Magazine",
      "imageVersion": 1
    },
    {
      "id": 1463,
      "name": "Football Insider",
      "imageVersion": 1
    },
    {
      "id": 623,
      "name": "Mirror",
      "imageVersion": 1
    }
  ]
}

Field Reference

News Article Fields

Field	Type	Description
id	integer	Unique article identifier
publishDate	string	ISO 8601 publication timestamp with timezone
sourceId	integer	Reference to news source
title	string	Article headline
image	string	Featured image URL
url	string	Full article URL with tracking
isMagazine	boolean	Editorial/magazine content flag (from internal editorial team)

News Source Fields

Field	Type	Description
id	integer	Unique source identifier
name	string	Source display name
imageVersion	integer	Image cache version

Use Cases

• Display latest football news on a sports dashboard
• Build a news feed with articles from multiple sources
• Filter editorial content using isMagazine flag
• Show source attribution with logos using sourceId mapping

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

competitions · integer

Filter by competition ID (e.g., 132 for NBA)

Example:

132

games · integer

Filter by game ID for match-specific news

limit · integer · default: 10

Maximum number of articles to return

Response

200

News articles retrieved successfully