Search Team by Name

This endpoint returns an array of Teams that meet your search criteria. Note that it will not return Teams that have never played any games that are not covered by your subscription plan.

GET Search Team by Name

https://soccer.sportmonks.com/api/v2.0/teams/search/{team_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.
seasons	Filter stats, topscorers (if included) based on a comma separated list of season ids. Can be used by adding &seasons= etc. to your request url.

Include options

country squad coach transfers sidelined stats venue fifaranking uefaranking visitorFixtures localFixtures visitorResults latest upcoming goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers league activeSeasons trophies rivals

Please note that the squad include only returns the squad of the current domestic season.

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/teams/search/manchester?api_token={API_TOKEN}

Response

 "data": [
        {
            "id": 9,
            "legacy_id": 127,
            "name": "Manchester City",
            "short_code": "MCI",
            "twitter": "@ManCity",
            "country_id": 462,
            "national_team": false,
            "founded": 1880,
            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/9/9.png",
            "venue_id": 151,
            "current_season_id": 18378,
            "is_placeholder": false
        },
        {
            "id": 14,
            "legacy_id": 375,
            "name": "Manchester United",
            "short_code": "MUN",
            "twitter": "@ManUtd",
            "country_id": 462,
            "national_team": false,
            "founded": 1878,
            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/14/14.png",
            "venue_id": 206,
            "current_season_id": 18378,
            "is_placeholder": false
        },
        {
            "id": 278,
            "legacy_id": 2533,
            "name": "United of Manchester",
            "short_code": null,
            "twitter": null,
            "country_id": 462,
            "national_team": false,
            "founded": 2005,
            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/22/278.png",
            "venue_id": 1125,
            "current_season_id": 18600,
            "is_placeholder": false
        },
        {
            "id": 654,
            "legacy_id": 8666,
            "name": "Manchester City U23",
            "short_code": null,
            "twitter": null,
            "country_id": 462,
            "national_team": false,
            "founded": 0,
            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/14/654.png",
            "venue_id": 12,
            "current_season_id": 18713,
            "is_placeholder": false
        },
        {
            "id": 666,
            "legacy_id": 8806,
            "name": "Manchester United U23",
            "short_code": null,
            "twitter": null,
            "country_id": 462,
            "national_team": false,
            "founded": null,
            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/26/666.png",
            "venue_id": 1208,
            "current_season_id": 18713,
            "is_placeholder": false
        },

Field Description

Field	Description
id	The unique id of the team
legacy_id	This was for our API version 1.0. It's only of use for old users of our API
name	The name of the team
short_code	The short code of the team
twitter	The official twitter page of the team
country_id	The unique country id the team is from
national_team	Indicates if the team is a national team
founded	The year when the team was founded
logo_path	The logo URL path of the team logo
venue_id	The official venue of the team
current_season_id	The unique id of the season the team is active in
is_placeholder	Added a property on both fixture and team responses called is_placeholder. This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

Check this endpoint in Postman.