crex.com APIcrex.com ↗
Access live cricket scores, scorecards, ball-by-ball commentary, ICC rankings, fixtures, and news from crex.com via 7 structured JSON endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/92abcb7e-38a3-4b91-97f1-5728b10e53ee/get_live_matches' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all currently live and recently completed cricket matches, including team names, current scores, match status, tournament/series name, venue, and match timestamps.
No input parameters required.
{
"type": "array",
"fields": {
"team1": "string, first team name",
"team2": "string, second team name",
"venue": "string, match venue",
"format": "string or null, match format (e.g. T20, ODI, Test, T20I)",
"score1": "string or null, first team first innings score",
"score2": "string or null, second team first innings score",
"series": "string, series/tournament name",
"status": "string, match result or status text",
"match_id": "string, unique match identifier",
"score1_2nd": "string or null, first team second innings score",
"score2_2nd": "string or null, second team second innings score",
"start_time": "integer or null, match start time as Unix timestamp in milliseconds",
"team1_short": "string or null, first team short name",
"team2_short": "string or null, second team short name"
},
"sample": {
"data": [
{
"team1": "Hyderabad Kingsmen",
"team2": "Islamabad United",
"venue": "Gaddafi Stadium, Lahore",
"format": "T20",
"score1": "186/5(20.0",
"score2": "184/7(20.0",
"series": "Pakistan Super League 2026",
"status": "Hyderabad Kingsmen won by 2 runs",
"match_id": "10XU",
"score1_2nd": null,
"score2_2nd": null,
"start_time": 1777644000000,
"team1_short": "HHK",
"team2_short": "ISU"
}
],
"status": "success"
}
}About the crex.com API
The Crex.com API covers 7 endpoints that expose live match data, full scorecards, ball-by-ball commentary, ICC rankings, fixtures, and cricket news. The get_live_matches endpoint returns every currently live and recently completed match with team names, scores, venue, format, and series name in a single call — no match ID required to start.
Live Matches, Scorecards, and Commentary
get_live_matches requires no inputs and returns a list of active and recently finished matches. Each object includes match_id, team1, team2, venue, format (T20, ODI, Test, T20I, or null), series, status, and both first- and second-innings scores via score1, score2, and score1_2nd. The match_id returned here is the key parameter you pass to downstream endpoints. get_match_scorecard takes that match_id and returns per-innings batting lines (player, runs, balls, fours, sixes, dismissal) and bowling figures (player, overs, runs, wickets, extras), along with the innings total and extras breakdown. get_match_live_commentary accepts a match_id and an optional last_doc_id for cursor-based pagination through older events. Each commentary entry carries a type field — b (ball), o (over summary), w (wicket), tm (team milestone), dh (day header), or wc (win confirmation) — plus over number, current score, primary text (c1), and detailed text (c2).
Match Info, Fixtures, and Rankings
get_match_info returns venue metadata, head-to-head records (hth), weather conditions (wU object with condition, temperature, and wind speed), and playing XIs encoded in the tp field. Venue average scores at various over marks are available in va. get_fixtures accepts a page index and grouping mode (wise: '1' groups by date) and returns scheduled and completed matches with team IDs, series IDs, scores, result text, and match format. get_rankings requires no inputs and returns ICC rankings across all three formats — test, odi, and t20 — with team names, rating points, and match counts.
News
get_news_list returns paginated cricket news articles. Each article object includes header, excerpt, newsUrl, cover_image_url, tags_array, and an optional attachedMatch field linking the article to a specific match. The next and prev boolean fields make it straightforward to walk through pages. The page and limit parameters control pagination.
- Build a live cricket score ticker using
get_live_matchesfor real-time team scores and match status. - Render a full match scorecard with batting and bowling figures for any completed or in-progress innings via
get_match_scorecard. - Implement ball-by-ball commentary feeds with wicket and milestone event filtering using the
typefield fromget_match_live_commentary. - Display weather and venue stats on a fantasy cricket app's match preview page using data from
get_match_info. - Populate a fixtures calendar grouped by date using
get_fixtureswithwise: '1'and paginated page inputs. - Show ICC team rankings tables for Test, ODI, and T20 formats from
get_rankingswithout any filtering parameters. - Attach breaking cricket news to match pages by cross-referencing
attachedMatchfields fromget_news_list.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does crex.com offer an official developer API?+
What event types appear in ball-by-ball commentary, and how do I distinguish them?+
get_match_live_commentary includes a type field. The values are: b for individual ball events (which carry c1 and c2 text fields), o for over summaries, w for wicket events, tm for team milestones, dh for day headers, and wc for win confirmation events. You filter on type to route events to the appropriate UI component or data handler.How do I paginate through older commentary entries?+
get_match_live_commentary endpoint uses cursor-based pagination. Each response entry includes an id integer field. Pass that value as last_doc_id in the next POST request for the same match_id to retrieve older entries. Omitting last_doc_id returns the most recent commentary.Does the API cover player profiles, career statistics, or historical match archives?+
Are series-level standings or points tables available?+
get_rankings and fixture metadata via get_fixtures, but tournament-level points tables and group standings are not included. You can fork the API on Parse and revise it to add a series standings endpoint.