search_players
1 creditStatic referencePOST /v1/search_players
Find players by name
Use it when you have a name and need the player id for the other endpoints. Accents are optional.
Parameters
querystringrequired- Part of the player's name, e.g. 'scheffler'.
limitintegeroptional- Max players (default 20).
leagueenum: golf | lpga | liv | dpwt | kornferryoptional- League. Defaults to golf. One of: golf, lpga, liv, dpwt, kornferry.
Notes
- Over MCP, ask for it in plain English and the client calls
search_playersitself. Point any MCP client athttps://mcp.birdieapi.com/mcp?key=YOUR_API_KEY. - Each call costs 1 credit, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.birdieapi.com/v1/search_players \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"query": "scheffler"
}'Response
json
{
"players": [
{
"player_id": "9478",
"name": "Scottie Scheffler",
"country": "USA",
"tournaments": 167,
"wins": 23,
"first_season": 2014,
"last_season": 2026
}
],
"count": 1
}Response fields
players[]array- List of objects
players[].player_idstringplayers[].namestringplayers[].countrystringplayers[].tournamentsnumberplayers[].winsnumberplayers[].first_seasonnumberplayers[].last_seasonnumbercountnumber
Used in
- Golf major winner odds by sportsbook: Pre-tournament winner prices for the Masters, PGA Championship, U.S. Open and Open Championship by sportsbook, from 2021, with how they moved. REST or MCP.
Related endpoints
get_scorecard2 cr
Takes the player_id this one returns.
A player's hole-by-hole scorecard for a tournament, with par and yardage
get_player5 cr
Takes the player_id this one returns.
Profile, rating, season lines and recent finishes
list_tournaments1 cr
Filters by the same limit and league.
A season's tournaments with dates, winner, purse and courses
get_schedule1 cr
Filters by the same league.
Tournaments this week and coming up, with the host course
Try it
500 free credits every month: 500 calls to search_players, and no card.