Yahoo Sports API endpoint
Returns source news articles. For league=soccer, Yahoo exposes a shared cross-competition /soccer/news/ feed and no competition-specific news filter; article tags are preserved verbatim.
/yahoo-sports/newsReturns recent news articles — ID, title, summary, author, publisher category, content type, published time, link, and Yahoo's complete embedded tag list when present — for a league from Yahoo Sports.
Query parameters:
league: required enum. Allowed values: nfl, nba, wnba, mlb, nhl, college-football, college-basketball, college-womens-basketball, soccer, mls, premier-league, la-liga, serie-a, bundesliga, ligue-1, champions-league, nwsl, ligamx-apertura, ligamx-clausura, copa-america, club-world-cup, world-cup, concacaf-champions-cup, concacaf-gold-cup, concacaf-league, womens-world-cup, europa-league, euro-championship.For all soccer keys, Yahoo publishes one shared /soccer/news/ feed; there is
no competition-specific news page or server-side competition/tag filter.
Article tags are retained as supplied by Yahoo.
Notable response behavior:
articles preserves Yahoo's own ordering (newest first).tags preserves Yahoo's source tag strings exactly; this can include topic labels, region labels, provider metadata, and editorial classification tags.league values return an invalid-parameter error before upstream IO.| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| title | 50 | median 92 characters |
| summary | 50 | median 99 characters |
| author | 50 | |
| published | 50 | 2026-10-11 to 2026-10-13 |
| url | 50 | sports.yahoo.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| league | string | Yes | League key Allowed values: nfl, nba, wnba, mlb, nhl, college-football, college-basketball, college-womens-basketball, soccer, mls, premier-league, la-liga, serie-a, bundesliga, ligue-1, champions-league, nwsl, ligamx-apertura, ligamx-clausura, copa-america, club-world-cup, world-cup, concacaf-champions-cup, concacaf-gold-cup, concacaf-league, womens-world-cup, europa-league, euro-championship. | nfl | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-sports/news?league=nfl" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"league": "nfl",
"count": 50,
"source_url": "https://sports.yahoo.com/nfl/news/",
"fetched_at": "2026-08-13T20:05:00Z",
"articles": [
{
"title": "NFL news, live updates: Joe Burrow, Ja'Marr Chase expected to play in Thursday's preseason game",
"summary": "Follow along with the latest NFL news and updates as the preseason plays out.",
"author": "Yahoo Sports Staff",
"category": "Sports",
"published": "2026-08-13T15:25:12Z",
"url": "https://sports.yahoo.com/nfl/live/nfl-news-preseason-schedule-whos-playing-live-updates-today-152512676.html"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoosports.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoosports.NewsResponse | No | ||||
| data.articles | array | No | ||||
| data.articles[].author | string | No | Yahoo Sports Staff | |||
| data.articles[].category | string | No | Sports | |||
| data.articles[].content_type | string | No | ||||
| data.articles[].id | string | No | ||||
| data.articles[].published | string | No | 2026-08-13T15:25:12Z | |||
| data.articles[].summary | string | No | ||||
| data.articles[].tags | array | No | ||||
| data.articles[].title | string | No | NFL news, live updates: ... | |||
| data.articles[].url | string | No | ||||
| data.count | integer | No | 50 | |||
| data.fetched_at | string | No | ||||
| data.league | string | No | nfl | |||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/yahoo-sports/news?league=nfl" \
-H "x-api-key: $CRAWLORA_API_KEY"