Cricbuzz API endpoint
Returns the public NewsArticle JSON-LD content and dynamic tags linked from the selected edition's Auction Live Blog tab. Not all editions expose this tab; Cricbuzz may return not found or a page without a NewsArticle. Discover tournament/year from cricbuzz/auction/seasons.
/cricbuzz/auction/live-blogReturns the public NewsArticle JSON-LD attached to the selected edition's Live Blog tab, including headline, canonical story URL, authors, published/modified timestamps, abstract, backstory, body HTML/text, inline Cricbuzz links, and typed keywords. This tab is edition-dependent: IPL 2026 exposes it, while SA20 2027 does not show it. If the source returns HTTP 404, the endpoint returns not found; if an HTML page loads without NewsArticle JSON-LD, it returns an upstream parse error.
tournament (required): ipl, wpl, sa20, hunm, hunw.year (required): IPL 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026; WPL 2023, 2024, 2025, 2026, 2027; SA20 2027; HUNM 2026; HUNW 2026.Tags retain their current source type (series, team, or topic) and label; the full set varies by story. The article body is public page content, preserved as returned in body_html with a normalized body_text string. This is a server-rendered article page, not an active bid-event feed.
| Field | Filled in, of 17 checked | Values in the sample |
|---|---|---|
| text | 17 | median 15 characters |
| url | 17 | cricbuzz.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| tournament | string | Yes | Tournament identifier from cricbuzz/auction/seasons: ipl, wpl, sa20, hunm, hunw | ipl | |
| year | string | Yes | Edition from cricbuzz/auction/seasons: IPL 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026; WPL 2023, 2024, 2025, 2026, 2027; SA20 2027; HUNM 2026; HUNW 2026 | 2026 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/live-blog?tournament=ipl&year=2026" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "ipl",
"year": "2026",
"season": "ipl-2026",
"story": {
"story_id": 136912,
"title": "LIVE BLOG: IPL 2026 Player Auction",
"url": "https://www.cricbuzz.com/cricket-news/136912/live-blog-ipl-2026-player-auction-abu-dhabi-ipl-mini-auction",
"authors": [
{
"name": "Cricbuzz Staff"
}
],
"published_at": "2025-12-16T08:34:33.000Z",
"tags": [
{
"type": "series",
"value": "Indian Premier League 2026"
},
{
"type": "topic",
"value": "Auction"
}
],
"body_text": "Welcome! Auction start. Player sold to CSK at base price."
}
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionLiveBlogResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionLiveBlogResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.season | string | No | ||||
| data.source_url | string | No | ||||
| data.story | cricbuzz.CricbuzzNewsStory | No | CricbuzzNewsStory record, 20 fields: abstract, authors, backstory, body_html, body_links, body_text, image_url, modified_at, published_at, story_id, tags, title and 1 more. Described under Get a public Cricbuzz NewsArticle API. | |||
| data.tournament | string | No | ||||
| data.year | 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/cricbuzz/auction/live-blog?tournament=ipl&year=2026" \
-H "x-api-key: $CRAWLORA_API_KEY"