Cricbuzz API endpoint
Returns only the selected edition's Auction Videos cards with video IDs, page URLs, titles, durations and thumbnail metadata. The global Featured Videos sidebar is excluded. If Cricbuzz displays No Videos Available, items is an explicit empty array with empty_state=no_videos. Discover tournament/year from cricbuzz/auction/seasons.
/cricbuzz/auction/videosReturns the selected edition's Auction Videos cards. This is separate from the global Featured Videos sidebar and the general video category/playlist directories. IPL 2026 currently returns ten video cards; SA20 2027 displays No Videos Available, returned as an empty items array with empty_state set to no_videos.
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.Cards preserve video IDs, canonical page URLs, title, duration, thumbnail ID/alt text, and relative-age labels. The endpoint does not return a media/playback URL. An absent grid without Cricbuzz's explicit empty-state marker is treated as upstream schema drift.
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| video_id | 10 | |
| slug | 10 | |
| title | 10 | “The unpredictable auction dynamics ft. Livingstone & Inglis” and 9 other values |
| url | 10 | cricbuzz.com |
| duration | 10 | “5:59” and 9 other values |
| image_id | 10 | |
| image_alt | 10 | “the-unpredictable-auction-dynamics-ft-livingstone-inglis” and 9 other values |
| time_ago | 10 | 10m ago in all 10 |
| 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/videos?tournament=ipl&year=2026" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "ipl",
"year": "2026",
"season": "ipl-2026",
"returned_count": 10,
"items": [
{
"video_id": 152119,
"slug": "the-unpredictable-auction-dynamics-ft-livingstone-inglis",
"title": "The unpredictable auction dynamics ft. Livingstone & Inglis",
"url": "https://www.cricbuzz.com/cricket-videos/152119/the-unpredictable-auction-dynamics-ft-livingstone-inglis",
"duration": "5:59",
"image_id": 801873,
"time_ago": "10m ago"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionVideosResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionVideosResponse | No | ||||
| data.empty_state | string | No | no_videos | EmptyState is populated only for Cricbuzz's explicit No Videos Available state. | ||
| data.fetched_at | string | No | ||||
| data.items | array | No | ||||
| data.items[].duration | string | No | ||||
| data.items[].image_alt | string | No | ||||
| data.items[].image_id | integer | No | ||||
| data.items[].slug | string | No | ||||
| data.items[].time_ago | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].url | string | No | ||||
| data.items[].video_id | integer | No | ||||
| data.returned_count | integer | No | ||||
| data.season | string | No | ||||
| data.source_url | string | No | ||||
| 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/videos?tournament=ipl&year=2026" \
-H "x-api-key: $CRAWLORA_API_KEY"