API Reference

List News Items

get
https://api.sportsstack.io/api/v1/news

Retrieves news items with flexible filtering options.

This endpoint supports filtering by entity type and ID to get news for specific players, teams, events, or leagues. You can also filter by league to get all news within a specific competition context.

Filtering Examples

  • Player News: ?for_entity_type=player&for_entity_id=123e4567-e89b-12d3-a456-426614174000
  • Team News: ?for_entity_type=team&for_entity_id=123e4567-e89b-12d3-a456-426614174001
  • Event News: ?for_entity_type=event&for_entity_id=123e4567-e89b-12d3-a456-426614174002
  • League News: ?league_id=32fa944f-b1bd-41b4-bec2-7ab269fde6fc

Content Freshness

News items are typically generated:

  • Game Recaps: Within 30 minutes of game completion
  • Player Insights: Daily during active seasons
  • Weekly Summaries: Monday mornings for previous week's activity

Response Format

Returns paginated news items sorted by date (newest first), with full content including all analysis sections, tags, and metadata.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

Filter by entity type. Supported values:

  • player - Individual player news and insights
  • team - Team performance analysis and updates
  • event - Game recaps and post-game analysis
Allowed:
uuid

Filter by specific entity ID (UUID). Must be used together with for_entity_type.

Examples:

  • Player ID: Get all news about a specific player
  • Team ID: Get all news about a specific team
  • Event ID: Get game recap and analysis for a specific event
uuid
required

Filter by league ID to get all news within a specific competition. Use this to get news across all entities (players, teams, events) within a league.

Popular league IDs:

  • NFL: 32fa944f-b1bd-41b4-bec2-7ab269fde6fc
  • NBA: 58e8c89b-72f8-4427-adbc-10f193c9b462

See /v1/leagues endpoint for complete list.

date

Filter news items from this date onwards (YYYY-MM-DD format)

date

Filter news items up to this date (YYYY-MM-DD format)

boolean
Defaults to false

Include entity tags in the response. Entity tags identify potential entity mentions in news content with confidence and relevance scores.

When enabled, each news item will include an entity_tags array containing:

  • entity_type: Type of entity (player, team, coach, etc.)
  • entity_id: Reference to the actual entity
  • entity_name: Display name of the entity
  • mentioned_as: The actual text that referenced the entity
  • confidence: 0.0-1.0 score indicating how confident we are this is the right entity
  • relevance: 0.0-1.0 score indicating how relevant/prominent this entity is in the content
  • context: Surrounding text context where entity was mentioned
  • reasoning: AI/algorithm reasoning for the tag

Use this to discover related entities mentioned in news content and build entity relationship graphs.

boolean
Defaults to true

Include news articles that mention the entity in their entity_tags (not just direct news).

When enabled and searching by for_entity_type/for_entity_id, the results will include:

  1. Direct news: Articles specifically about the entity (original behavior)
  2. Mentioned news: Articles that mention the entity with sufficient confidence

For example, when searching for a specific player, you'll get both:

  • Player performance analysis articles (direct)
  • Game recap articles that mention the player significantly (mentioned)

This provides a more comprehensive view of entity-related content.

number
0 to 1
Defaults to 0.7

Minimum confidence threshold for including entity mention matches (0.0-1.0).

Only applies when include_entity_mentions=true. Higher values return more precise matches but may miss some relevant content. Lower values return more comprehensive results but may include less relevant mentions.

Recommended values:

  • 0.9+: Very high precision, only strongest entity mentions
  • 0.7-0.8: Balanced precision and recall (default)
  • 0.5-0.6: Broader results, may include some less relevant mentions
  • <0.5: May include many low-confidence matches
integer
≥ 1
Defaults to 1

Page number

integer
1 to 1000
Defaults to 50

Number of items per page (max 1000)

Responses

Callback

Updated 3 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago