Search Player by Name

GET Search Player by Name

https://soccer.sportmonks.com/api/v2.0/players/search/{player_name}

Endpoint details
Authorization	API Key
Pagination	NO
Allowed nested includes	2

Parameters

Available parameters
include	Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

Include options

position team stats trophies sidelined transfers lineups country

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Includes

Example response

Request

https://soccer.sportmonks.com/api/v2.0/players/search/James Forrest?api_token={API_TOKEN}

Response

 "data": [
        {
            "player_id": 172104,
            "team_id": 53,
            "country_id": 1161,
            "position_id": 3,
            "common_name": "J. Forrest",
            "display_name": "James Forrest",
            "fullname": "James Forrest",
            "firstname": "James",
            "lastname": "Forrest",
            "nationality": "Scotland",
            "birthdate": "07/07/1991",
            "birthcountry": "Scotland",
            "birthplace": "Prestwick",
            "height": "175 cm",
            "weight": null,
            "image_path": "https://cdn.sportmonks.com/images/soccer/players/8/172104.png"
        },
        {
            "player_id": 12724,
            "team_id": 382,
            "country_id": 462,
            "position_id": 4,
            "common_name": "D. Forrest",
            "display_name": "Danny Forrest",
            "fullname": "Danny Forrest",
            "firstname": "Danny",
            "lastname": "Forrest",
            "nationality": "England",
            "birthdate": "23/10/1984",
            "birthcountry": "England",
            "birthplace": "Keighley",
            "height": "180 cm",
            "weight": null,
            "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
        },
        {
            "player_id": 174304,
            "team_id": 258,
            "country_id": 1161,
            "position_id": 4,
            "common_name": "A. Forrest",
            "display_name": "Alan Forrest",
            "fullname": "Alan Forrest",
            "firstname": "Alan",
            "lastname": "Forrest",
            "nationality": "Scotland",
            "birthdate": "09/09/1996",
            "birthcountry": "Scotland",
            "birthplace": "Irvine",
            "height": "175 cm",
            "weight": null,
            "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
        },
        {
            "player_id": 174484,
            "team_id": null,
            "country_id": 1161,
            "position_id": 2,
            "common_name": "F. Forrest",
            "display_name": "Fraser Forrest",
            "fullname": "Fraser Forrest",
            "firstname": "Fraser",
            "lastname": "Forrest",
            "nationality": "Scotland",
            "birthdate": "14/09/1983",
            "birthcountry": "Scotland",
            "birthplace": "Galashiels",
            "height": null,
            "weight": null,
            "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
        },
        {
            "player_id": 175004,
            "team_id": null,
            "country_id": 1161,
            "position_id": 2,
            "common_name": "E. Forrest",
            "display_name": "Eddie Forrest",
            "fullname": "Eddie Forrest",
            "firstname": "Eddie",
            "lastname": "Forrest",
            "nationality": "Scotland",
            "birthdate": "17/12/1978",
            "birthcountry": "Scotland",
            "birthplace": "Edinburgh",
            "height": "183 cm",
            "weight": "80 kg",
            "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
        },

Field Description

Field	Description
player_id	The unique id of the main player
team_id	The unique id of the team the player belongs to
country_id	The unique id of the country the player is from
position_id	The unique id of the position the player plays in
common_name	The common name the player is known for
display_name	The display name of the player. Often used to show in the lineup formation
fullname	The full name of the player
firstname	The first name of the player
lastname	The last name of the player
nationality	The nationality of the player
birthdate	The date of birth of the player
birthcountry	The country the player was born in
birthplace	The place the player was born in
height	The height of the player
weight	The weight of the player
image_path	The URL of the player image

Check this endpoint in Postman.