Search news

GET/v1/news/search

Full-text search across the news archive with entity, league, and date-range filters. Supports phrase queries.

Code samples

# Get live scores across every league
curl "https://api.sportapi.io/v1/nba/scores/live" \
  -H "Authorization: Bearer $API_KEY"

# Response
{
  "games": [{
    "game_id": "0022500412",
    "status": "in_progress",
    "period": 3, "clock": "07:42",
    "home": { "team": "BOS", "score": 78 },
    "away": { "team": "LAL", "score": 71 },
    "last_play": "J. Tatum makes 3-pt jumper from 25 ft"
  }]
}

Query parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (supports phrases in quotes)
`league`	string	No	Filter by league
`date_from`	string	No	Start of date range
`date_to`	string	No	End of date range

Response

{
  "query": "lebron james trade",
  "results": [
    { "id": "news_8f3a2b1c", "headline": "...", "highlight": "...trade rumors involving <em>LeBron James</em>..." }
  ],
  "meta": { "count": 47, "took_ms": 18 }
}

Error responses

Status	Code	Description
401	`unauthorized`	Missing or invalid API key
403	`tier_insufficient`	Your plan tier doesn't include this resource
429	`rate_limited`	Exceeded rate limit; honor Retry-After
500	`internal_error`	Server error; retry with exponential backoff