FOOTBALL API V1
Endpoint Description
This endpoint allows users to search for football-related information globally based on a specified query. In this case, the query is set to "Barcelona", which will return relevant data associated with the search term.
Request Format
Method: GET
URL:
https://apiv3.sportsapi360.com/football/api/v1/global/searchQuery Parameters:
query(string): The search term used to find relevant football data. In this example, the query is set to "Barcelona".
Response Structure
The response from this endpoint will be in JSON format and consists of the following structure:
status (boolean): Indicates whether the request was successful.
statusCode (integer): A code representing the status of the request.
message (string): A message providing additional context about the request's status (may be empty).
response (array): An array containing the search results, where each result has the following properties:
id (integer): A unique identifier for the football entity.
name (string): The name of the football entity.
nameCode (string): A code representing the name of the football entity.
national (boolean): Indicates if the entity is national.
type (string): The type of entity (e.g., player, team).
gender (string): The gender associated with the entity.
country (object): An object containing country information:
alpha2 (string): The two-letter country code.
name (string): The name of the country.
score (integer): A score associated with the search result.
This structure provides a comprehensive overview of the search results related to the specified query.
Authorizations
HTTPRequired
Query parameters
querystringOptionalExample:
BarcelonaHeader parameters
x-api-keystringOptional
Responses
200
OK
text/plain
stringOptional
get/football/api/v1/global/search
GET /football/api/v1/global/search HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
200
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"type": "team",
"gender": "M",
"country": {
"alpha2": "ES",
"name": "Spain"
},
"score": 5679633.5
},
{
"id": 77889,
"name": "Fútbol Club Barcelona",
"nameCode": "FCB",
"national": false,
"type": "team",
"gender": "F",
"country": {
"alpha2": "ES",
"name": "Spain"
},
"score": 1557857
},
{
"id": 1402912,
"name": "Lamine Yamal",
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "L. Yamal",
"position": "M",
"jerseyNumber": "10",
"sofascoreId": "Lamiyamal",
"score": 1333226.8,
"type": "player"
},
{
"id": 831005,
"name": "Raphinha",
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "BR",
"name": "Brazil"
},
"shortName": "Raphinha",
"position": "M",
"jerseyNumber": "11",
"sofascoreId": "Raphinha",
"score": 1106442.1,
"type": "player"
},
{
"id": 992587,
"name": "Pedri",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "Pedri",
"position": "M",
"jerseyNumber": "8",
"sofascoreId": "Pedri",
"score": 1007743.1,
"type": "player"
},
{
"id": 41789,
"name": "Robert Lewandowski",
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "PL",
"name": "Poland"
},
"shortName": "R. Lewandowski",
"position": "F",
"jerseyNumber": "9",
"sofascoreId": "Lewa",
"score": 951792.1,
"type": "player"
},
{
"id": 2814,
"name": "Espanyol",
"nameCode": "ESP",
"national": false,
"type": "team",
"gender": "M",
"country": {
"alpha2": "ES",
"name": "Spain"
},
"score": 713663.9
},
{
"id": 1103693,
"name": "Pablo Gavi",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "Gavi",
"position": "M",
"jerseyNumber": "6",
"sofascoreId": "Gavi",
"score": 700676,
"type": "player"
},
{
"id": 5250,
"name": "Barcelona SC",
"nameCode": "BSC",
"national": false,
"type": "team",
"gender": "M",
"country": {
"alpha2": "EC",
"name": "Ecuador"
},
"score": 696756.3
},
{
"id": 24343,
"name": "Barcelona Atlètic",
"nameCode": "BAT",
"national": false,
"type": "team",
"gender": "M",
"country": {
"alpha2": "ES",
"name": "Spain"
},
"score": 623996.06
},
{
"id": 789071,
"name": "Dani Olmo",
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "D. Olmo",
"position": "M",
"jerseyNumber": "20",
"sofascoreId": "DaniOlmo",
"score": 616753.75,
"type": "player"
},
{
"id": 814590,
"name": "Marcus Rashford",
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "EN",
"name": "England"
},
"shortName": "M. Rashford",
"position": "M",
"jerseyNumber": "14",
"sofascoreId": "Rashford",
"score": 593406,
"type": "player"
},
{
"id": 795222,
"name": "Frenkie de Jong",
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "NL",
"name": "Netherlands"
},
"shortName": "F. de Jong",
"position": "M",
"jerseyNumber": "21",
"sofascoreId": "Frenkie",
"score": 578420.8,
"type": "player"
},
{
"id": 827212,
"name": "Jules Koundé",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "FR",
"name": "France"
},
"shortName": "J. Koundé",
"position": "D",
"jerseyNumber": "23",
"sofascoreId": "JKoundé",
"score": 528532.7,
"type": "player"
},
{
"id": 1402913,
"name": "Pau Cubarsí",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "P. Cubarsí",
"position": "D",
"jerseyNumber": "2",
"sofascoreId": "PauCubarsí",
"score": 523334.44,
"type": "player"
},
{
"id": 925097,
"name": "Ronald Araújo",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "UY",
"name": "Uruguay"
},
"shortName": "R. Araújo",
"position": "D",
"jerseyNumber": "4",
"sofascoreId": "RAraújo",
"score": 500032.56,
"type": "player"
},
{
"id": 855833,
"name": "Ferran Torres",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "F. Torres",
"position": "F",
"jerseyNumber": "7",
"sofascoreId": "FerranTorres",
"score": 450841.84,
"type": "player"
},
{
"id": 997035,
"name": "Alejandro Balde",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "A. Balde",
"position": "D",
"jerseyNumber": "3",
"sofascoreId": "AlejandroBalde",
"score": 442786.3,
"type": "player"
},
{
"id": 1153270,
"name": "Fermín López",
"retired": false,
"team": {
"id": 2817,
"name": "Barcelona",
"nameCode": "BAR",
"national": false,
"gender": "M"
},
"deceased": false,
"country": {
"alpha2": "ES",
"name": "Spain"
},
"shortName": "F. López",
"position": "M",
"jerseyNumber": "16",
"sofascoreId": "FermínLópez",
"score": 439889.25,
"type": "player"
},
{
"id": 90128,
"name": "Barcelona U19",
"nameCode": "BAR",
"national": false,
"type": "team",
"gender": "M",
"country": {
"alpha2": "ES",
"name": "Spain"
},
"score": 408461.03
}
]
}Last updated