Search Player by Name
GET https://soccer.sportmonks.com/api/v2.0/players/search/:PLAYER_NAME
Introduction
This endpoint returns an array of Players that meet your search criteria. The Players endpoint provides you detailed Player information. With this endpoint you will be able to build a complete Player Profile.
By using for example the Stats Include it is possible to see the progression of the Player over the current domestic season. Those are also available for historic Seasons, starting from 2017.
Pagination
NO - Indicates if this endpoint contains pagination.
Nested Includes
2 - You can add a maximum of 2 levels of nested includes.
Includes Options
position team stats trophies sidelined transfers lineups country
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
include | null | Enrich the API with more data and/or nested includes |
RESPONSES
status: OK
{"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"}],"meta":{"subscription":{"started_at":{"date":"2019-09-02 09:52:14.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":{"date":"2019-09-16 09:52:10.000000","timezone_type":3,"timezone":"UTC"},"ends_at":null},"plan":{"name":"PostMan Plan","price":"25.00","request_limit":"2000,60"},"sports":[{"id":1,"name":"Soccer","current":true}]}}