---
title: "ESPN league news"
method: GET
path: "/espn/news"
tags: ["ESPN"]
---

# ESPN league news

`GET /espn/news`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/espn/news`
- Auth: API key in header `x-api-key`

Returns recent news articles (headline, description, link) for a league. The `sport` enum accepts `football`, `basketball`, `baseball`, `hockey`, and `soccer`. The `league` enum accepts `nfl`, `college-football`, `nba`, `wnba`, `mens-college-basketball`, `womens-college-basketball`, `mlb`, `nhl`, `eng.1`, `esp.1`, `ita.1`, `ger.1`, `fra.1`, `usa.1`, and `uefa.champions`; it must be valid for the chosen sport.

## Query parameters

- `sport` 'football' | 'basketball' | 'baseball' | 'hockey' | 'soccer', required
- `league` 'nfl' | 'college-football' | 'nba' | 'wnba' | 'mens-college-basketball' | 'womens-college-basketball' | 'mlb' | 'nhl' | 'eng.1' | 'esp.1' | 'ita.1' | 'ger.1' | 'fra.1' | 'usa.1' | 'uefa.champions', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- EspnNewsResponseDoc
  - `code` integer
  - `data` EspnNewsResponse
    - `articles` EspnNewsArticle[]: Recent news articles for the league, one entry per article.
      - `byline` string: Name of the article's author.
      - `description` string: Short summary of the article.
      - `headline` string: Article headline as shown on ESPN.
      - `link` string: URL of the article on ESPN.
      - `published` string: Time the article was published, in ISO 8601.
      - `type` string: Article type as ESPN labels it.
    - `count` integer: Number of articles returned.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `league` string: League key that was requested, for example `nfl`.
    - `source_url` string: URL the data was read from.
    - `sport` string: Sport key that was requested, for example `football`.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)