Crickk API — Documentation

Base URL
https://crickkapi.vercel.app/api

Overview

This page documents the public endpoints exposed by the Crickk API. Examples below use curl and sample responses are provided for reference. For premium access and higher rate limits contact email me here.

Endpoints

GET /playerStats
Retrieve career statistics for a player by player ID.
Auth: X-API-Key (required for premium)

Query parameters

NameTypeRequiredDescription
idstringYesPlayer ID

Example (curl)

curl "https://crickkapi.vercel.app/api/playerStats?id=793441"

Sample response

{"battingStyles":["right-hand bat"],"bowlingStyles":["right-arm medium-fast"],"country":"Pakistan","dateOfBirth":{"date":5,"month":7,"year":1996},"fullName":"Aamer Jamal","intlCareerSpan":"2022 - 2025","playingRoles":["allrounder"],"stats":{"BATTING":{"First-class":{"100s":0,"4s":136,"50s":4,"6s":17,"Avg":22.43,"Balls":1915,"CT":21,"HS":"82","Inn":55,"Mat":38,"NOs":7,"Runs":1077,"SR":56.24,"Stumpings":0},"List A":{"100s":0,"4s":22,"50s":1,"6s":12,"Avg":12.28,"Balls":357,"CT":10,"HS":"74","Inn":28,"Mat":34,"NOs":3,"Runs":307,"SR":85.99,"Stumpings":0},"One-Day Internationals":{"100s":0,"4s":1,"50s":0,"6s":0,"Avg":null,"Balls":9,"CT":0,"HS":"5*","Inn":2,"Mat":3,"NOs":2,"Runs":5,"SR":55.55,"Stumpings":0},"Tests":{"100s":0,"4s":40,"50s":2,"6s":6,"Avg":27.07,"Balls":614,"CT":5,"HS":"82","Inn":15,"Mat":8,"NOs":2,"Runs":352,"SR":57.32,"Stumpings":0},"Twenty20":{"100s":0,"4s":53,"50s":1,"6s":26,"Avg":19.44,"Balls":345,"CT":21,"HS":"87","Inn":40,"Mat":47,"NOs":13,"Runs":525,"SR":152.17,"Stumpings":0},"Twenty20 Internationals":{"100s":0,"4s":5,"50s":0,"6s":7,"Avg":22,"Balls":49,"CT":1,"HS":"41","Inn":5,"Mat":6,"NOs":1,"Runs":88,"SR":179.59,"Stumpings":0}},"BOWLING":{"First-class":{"10WI":0,"4WI":1,"5WI":5,"Avg":33.75,"BBI":"8/120","BBM":"8/120","Balls":5179,"ECON":3.83,"Inn":60,"Mat":38,"Runs":3308,"SR":52.8,"Wkts":98},"List A":{"10WI":0,"4WI":1,"5WI":1,"Avg":29.33,"BBI":"5/75","BBM":"5/75","Balls":1474,"ECON":6.68,"Inn":34,"Mat":34,"Runs":1643,"SR":26.3,"Wkts":56},"One-Day Internationals":{"10WI":0,"4WI":0,"5WI":0,"Avg":28.33,"BBI":"2/19","BBM":"2/19","Balls":96,"ECON":5.31,"Inn":3,"Mat":3,"Runs":85,"SR":32,"Wkts":3},"Tests":{"10WI":0,"4WI":0,"5WI":2,"Avg":32.85,"BBI":"6/69","BBM":"7/139","Balls":893,"ECON":4.63,"Inn":11,"Mat":8,"Runs":690,"SR":42.5,"Wkts":21},"Twenty20":{"10WI":0,"4WI":0,"5WI":1,"Avg":33.62,"BBI":"5/23","BBM":"5/23","Balls":865,"ECON":10.03,"Inn":47,"Mat":47,"Runs":1446,"SR":20.1,"Wkts":43},"Twenty20 Internationals":{"10WI":0,"4WI":0,"5WI":0,"Avg":93.5,"BBI":"1/13","BBM":"1/13","Balls":101,"ECON":11.1,"Inn":6,"Mat":6,"Runs":187,"SR":50.5,"Wkts":2}}}}}
GET /playerSearch
Search players by name.
Auth: optional

Query parameters

NameTypeRequiredDescription
namestringYesPlayer name (partial or full)

Example (curl)

curl "https://crickkapi.vercel.app/api/playerSearch?name=Virat%20Kohli"

Sample response

{"Players":[{"battingStyles":["right-hand bat"],"bowlingStyles":["right-arm medium"],"dateOfBirth":{"date":5,"month":11,"year":1988},"dateOfDeath":null,"gender":"M","id":253802,"name":"Virat Kohli","team":"India"},{"battingStyles":["left-hand bat"],"bowlingStyles":["right-arm offbreak"],"dateOfBirth":{"date":12,"month":4,"year":2000},"dateOfDeath":null,"gender":"F","id":1190585,"name":"Asmita Kohli","team":"Germany"},{"battingStyles":["right-hand bat"],"bowlingStyles":[],"dateOfBirth":{"date":15,"month":8,"year":1941},"dateOfDeath":null,"gender":"M","id":30633,"name":"Gopal Kohli","team":"India"},{"battingStyles":[],"bowlingStyles":[],"dateOfBirth":null,"dateOfDeath":null,"gender":"M","id":265588,"name":"M Kohli","team":"India"},{"battingStyles":["right-hand bat"],"bowlingStyles":["legbreak googly"],"dateOfBirth":{"date":9,"month":8,"year":1996},"dateOfDeath":null,"gender":"M","id":1083129,"name":"Parth Kohli","team":"India"},{"battingStyles":["right-hand bat"],"bowlingStyles":[],"dateOfBirth":{"date":2,"month":3,"year":1964},"dateOfDeath":null,"gender":"M","id":30414,"name":"Ravi Kohli","team":"India"},{"battingStyles":[],"bowlingStyles":[],"dateOfBirth":null,"dateOfDeath":null,"gender":"M","id":30634,"name":"Surinder Kohli","team":"India"},{"battingStyles":[],"bowlingStyles":[],"dateOfBirth":{"date":6,"month":5,"year":1986},"dateOfDeath":null,"gender":"M","id":304692,"name":"Somesh Kohli","team":"Netherlands"},{"battingStyles":["right-hand bat"],"bowlingStyles":["right-arm medium"],"dateOfBirth":{"date":17,"month":12,"year":1988},"dateOfDeath":null,"gender":"M","id":331855,"name":"Taruwar Kohli","team":"India"},{"battingStyles":["right-hand bat"],"bowlingStyles":["right-arm medium-fast"],"dateOfBirth":{"date":13,"month":8,"year":1989},"dateOfDeath":null,"gender":"F","id":960925,"name":"Akanksha Kohli","team":"India"},{"battingStyles":["right-hand bat"],"bowlingStyles":["right-arm medium-fast"],"dateOfBirth":{"date":5,"month":12,"year":1996},"dateOfDeath":null,"gender":"M","id":1246446,"name":"Nikhil Kohli","team":"India"},{"battingStyles":["right-hand bat"],"bowlingStyles":[],"dateOfBirth":{"date":9,"month":6,"year":1974},"dateOfDeath":null,"gender":"F","id":1313534,"name":"Smriti Kohli","team":"Austria"},{"battingStyles":[],"bowlingStyles":[],"dateOfBirth":{"date":6,"month":12,"year":1920},"dateOfDeath":{"date":20,"month":10,"year":2001},"gender":"M","id":30831,"name":"Lalchand Kohli","team":"India"},{"battingStyles":[],"bowlingStyles":[],"dateOfBirth":{"date":8,"month":6,"year":1965},"dateOfDeath":null,"gender":"M","id":1486258,"name":"Pawan Kohli","team":"Austria"},{"battingStyles":["right-hand bat"],"bowlingStyles":["legbreak"],"dateOfBirth":{"date":2,"month":5,"year":1997},"dateOfDeath":null,"gender":"M","id":1201527,"name":"Shashwat Kohli","team":"India"},{"battingStyles":["left-hand bat"],"bowlingStyles":["legbreak googly"],"dateOfBirth":{"date":8,"month":12,"year":1997},"dateOfDeath":null,"gender":"M","id":720465,"name":"Virat Singh","team":"India"}]}

Authentication & Rate Limits

All premium requests require the X-API-Key header. Free-tier limits are enforced server-side.

TierRate limit
Free3 requests/minute
Premium50 requests/minute

To obtain a premium key or integrate this API into your application, contact akhawer875@gmail.com.

Errors

The API uses conventional HTTP status codes. Common responses:

HTTPMeaning
200Success
400Bad request — missing or invalid parameters
401Unauthorized — invalid or missing API key for premium endpoint
429Rate limit exceeded
500Server error