Cricinfo API endpoint
Returns a public Cricinfo news article, match report, preview, or live blog. The response includes stable story metadata, typed content blocks, live-blog entries when present, and related links.
/cricinfo/storyQuery parameters:
url (required): canonical Cricinfo /story/..., match-report, match-preview, or live-match-blog URL.The response normalizes story metadata and typed content blocks. Article prose remains HTML so links and emphasis are preserved. Live blogs also include timeline entries.
| Field | Filled in, of 5 checked | Values in the sample |
|---|---|---|
| type | 5 | HTML (4), IMAGE (1) |
| image_url | 1 | cricinfo.com |
| caption | 1 | median 96 characters |
| html | 4 | median 290 characters |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical Cricinfo story, report, preview, or live-blog URL | https://www.cricinfo.com/story/lutho-sipamla-ruled-out-of-namibia-tri-series-with-hamstring-injury-1552225 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricinfo/story?url=https%3A%2F%2Fwww.cricinfo.com%2Fstory%2Flutho-sipamla-ruled-out-of-namibia-tri-series-with-hamstring-injury-1552225" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"story": {
"id": "1552225",
"title": "Sipamla ruled out of Namibia tri-series",
"genre": "NEWS"
},
"blocks": [
{
"type": "HTML",
"html": "..."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/cricinfo.storyResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricinfo.StoryResponse | No | ||||
| data.blocks | array | No | ||||
| data.blocks[].caption | string | No | ||||
| data.blocks[].html | string | No | ||||
| data.blocks[].image_url | string | No | ||||
| data.blocks[].type | string | No | ||||
| data.blocks[].video_id | string | No | ||||
| data.blocks[].video_title | string | No | ||||
| data.blog_entries | array | No | ||||
| data.blog_entries[].blocks | array | No | ||||
| data.blog_entries[].blocks[].caption | string | No | ||||
| data.blog_entries[].blocks[].html | string | No | ||||
| data.blog_entries[].blocks[].image_url | string | No | ||||
| data.blog_entries[].blocks[].type | string | No | ||||
| data.blog_entries[].blocks[].video_id | string | No | ||||
| data.blog_entries[].blocks[].video_title | string | No | ||||
| data.blog_entries[].id | string | No | ||||
| data.blog_entries[].pinned | boolean | No | ||||
| data.blog_entries[].published_at | string | No | ||||
| data.blog_entries[].title | string | No | ||||
| data.fetched_at | string | No | ||||
| data.related | array | No | ||||
| data.related[].id | string | No | ||||
| data.related[].title | string | No | ||||
| data.related[].type | string | No | ||||
| data.related[].url | string | No | ||||
| data.source_url | string | No | ||||
| data.story | cricinfo.NewsStory | No | NewsStory record, 13 fields: byline, genre, id, image_url, live, live_blog, match_id, modified_at, published_at, series_id, summary, title and 1 more. Described under Cricinfo news API. | |||
| 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/cricinfo/story?url=https%3A%2F%2Fwww.cricinfo.com%2Fstory%2Flutho-sipamla-ruled-out-of-namibia-tri-series-with-hamstring-injury-1552225" \
-H "x-api-key: $CRAWLORA_API_KEY"