Skip to content

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_players itself. Point any MCP client at https://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_idstring
players[].namestring
players[].countrystring
players[].tournamentsnumber
players[].winsnumber
players[].first_seasonnumber
players[].last_seasonnumber
countnumber

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

Try it

500 free credits every month: 500 calls to search_players, and no card.