Skip to content

Grab your football API data for FIFA World Cup 2022 competition!

Notifications You must be signed in to change notification settings

rezarahiminia/free-api-worldcup2022

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 

Repository files navigation

"Buy Me A Coffee"

WORLD CUP API - 2022 DATA SET

Live Scores(Real-time player stats)

free-api-worldcup2022

World Cup 2022

Grab your football API data for FIFA World Cup 2022 competition!

Register

To use the services, you must register (free registration) You need a token to call services

Http Metod : POST http://api.cup2022.ir/api/v1/user

Request

curl --location --request POST 'http://api.cup2022.ir/api/v1/user' \
--header 'Content-Type: application/json' \
--data-raw '{
"name" : "Reza RAhiminia",
"email": "[email protected]",
"password": "******",
"passwordConfirm" : "******"
}'

Response

{
	"status": "success",
	"message": "User created",
		"data": {
		"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI2MjliMjJlYTZiOGYwZTVlNGNkZDcxZDMiLCJpYXQiOjE2NTQzMzQxODYsImV4cCI6MTY1NDQyMDU4Nn0.zgWUXkDCcche_5G9UnPB4VeXP68IKIRZm1UfjM457tU"
		}
}

Login

Be sure to log in to use the services You need a token to call services

Http Metod : POST http://api.cup2022.ir/api/v1/user/login

Request

curl --location --request POST 'http://api.cup2022.ir/api/v1/user/login' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "[email protected]",
"password": "12345678"
}'

Response

{
"status": "success",
	"data": {
	"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI2MjliMjJlYTZiOGYwZTVlNGNkZDcxZDMiLCJpYXQiOjE2NTQzMzQzMTgsImV4cCI6MTY1NDQyMDcxOH0.fP6smP8HB_QHQhAPktB08FEMor_BqOQhzlgXNkN756U"
	}
}

Teams

A request on Team endpoint returns all information about the All Team

Http Metod : GET http://api.cup2022.ir/api/v1/team

A request on Team endpoint returns all information about the by Team

Http Metod : GET http://api.cup2022.ir/api/v1/team/{id}

Request

curl --location --request GET 'http://api.cup2022.ir/api/v1/team' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \

Response

{
	"status": "success",
	"data": [
		{
			"_id": "62965f29800713e332e613f8",
			"name_en": "Iran",
			"name_fa": "ایران",
			"flag": "https://en.wikipedia.org/wiki/File:Flag_of_Iran.svg",
			"fifa_code": "IRN",
			"iso2": "IR",
			"groups": "B",
			"id": "6"

		}]
}

Matches

A request on Matches endpoint returns all Matches information

Http Metod : GET http://api.cup2022.ir/api/v1/match

A request on Matches endpoint returns all information for the requested day (e.g. 2 is second day's matches of cup) [day match's]

Http Metod : GET http://api.cup2022.ir/api/v1/bymatch/{id}

A request on Matches endpoint returns all information about the Match [match]

Http Metod : GET http://api.cup2022.ir/api/v1/match/{id}

A request on Matches endpoint returns all information about the Match [date match]

Http Metod : POST http://api.cup2022.ir/api/v1/bydate

{"date":"12/2/2022"}

Request

curl --location --request GET 'http://api.cup2022.ir/api/v1/match' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \

Response

{

	"status": "success",
	"data": [
		{
		"id": 1,
		"type": "group",
		"group": "A",
		"home_team_id": "3",
		"away_team_id": "4",
		"home_score": 0,
		"away_score": 0,
		"home_scorers": null,
		"away_scorers": null,
		"persian_date": "1400-08-30 13:30",
		"local_date": "2022-11-21 1:00 PM",
		"stadium_id": "1",
		"time_elapsed": "finished",      notstarted | h1 | hf | h2 | finished
		"finished": "true",
		"matchday": 1,
		"home_team_fa": "سنگال",
		"away_team_fa": "هلند",
		"home_team_en": "Senegal",
		"away_team_en": "Nederland",
		"home_flag": "https://upload.wikimedia.org/wikipedia/commons/thumb/f/fd/Flag_of_Senegal.svg/125px-Flag_of_Senegal.svg.png",
		"away_flag": "https://upload.wikimedia.org/wikipedia/commons/thumb/2/20/Flag_of_the_Netherlands.svg/125px-Flag_of_the_Netherlands.svg.png"
		}]
}

Standings

A request on Standings endpoint returns all Standings information

Http Metod : GET http://api.cup2022.ir/api/v1/standings

A request on Standings endpoint returns all information Standings by group [day match's]

Http Metod : GET http://api.cup2022.ir/api/v1/standings/{group name : A,B,...}

Request

curl --location --request GET 'http://api.cup2022.ir/api/v1/standings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \

Response

{
"status": "success",
"data": [
		{
		"group": "A",
		"teams": [
						{
						"team_id": "1",
						"mp": "0",
						"w": "0",
						"l": "0",
						"pts": "0",
						"gf": "0",
						"ga": "0",
						"gd": "0",
						"d": "0",
						"name_fa": "قطر",
						"name_en": "Qatar",
						"flag": "https://upload.wikimedia.org/wikipedia/commons/thumb/6/65/Flag_of_Qatar.svg/125px-Flag_of_Qatar.svg.png"
						},
						{
						"team_id": "2",
						"mp": "0",
						"w": "0",
						"l": "0",
						"pts": "0",
						"gf": "0",
						"ga": "0",
						"gd": "0",
						"d": "0",
						"name_fa": "اکوادور",
						"name_en": "Ecuador",
						"flag": "https://upload.wikimedia.org/wikipedia/commons/thumb/e/e8/Flag_of_Ecuador.svg/125px-Flag_of_Ecuador.svg.png"
						},
						{
						"team_id": "3",
						"mp": "0",
						"w": "0",
						"l": "0",
						"pts": "0",
						"gf": "0",
						"ga": "0",
						"gd": "0",
						"d": "0",
						"name_fa": "سنگال",
						"name_en": "Senegal",
						"flag": "https://upload.wikimedia.org/wikipedia/commons/thumb/f/fd/Flag_of_Senegal.svg/125px-Flag_of_Senegal.svg.png"
						},
						{
						"team_id": "4",
						"mp": "0",
						"w": "0",
						"l": "0",
						"pts": "0",
						"gf": "0",
						"ga": "0",
						"gd": "0",
						"d": "0",
						"name_fa": "هلند",
						"name_en": "Nederland",
						"flag": "https://upload.wikimedia.org/wikipedia/commons/thumb/2/20/Flag_of_the_Netherlands.svg/125px-Flag_of_the_Netherlands.svg.png"
						}]

		}]

}

standings info

 "mp" =>  matches played
 "w"    =>  matches won
 "l"      =>  matches lost
 "pts"  =>  point / score
 "gf"   =>   goals for
 "ga"  =>   goals against
 "gd"  =>   goals difference
 "d"  =>     drawn

###The number of users using this service until 28 Oct 2022

country account
united States 4289
china 3394
brazil 1318
vietnam 738
germany 548
poland 450
israel 352
switzerland 290
argentina 259
chile 231
netherlans 190
taiwan 189
nepal 171
canada 161
united kingdom 155
france 143
iran 116
india 93
colombia 91
morocco 86
finland 86
denmark 81
mexico 75
australia 68
japan 63
bangladesh 62
paraguay 58
uruguay 49
united arab 49
sweden 49
indonesia 48
korea 43
belgium 40
guatemala 36
ecuador 34
russian federation 30
thailand 29
malaysia 29
romania 26
venezuela 25
ireland 21
bolivia 19
peru 18
egypt 17
egypt 17
egypt 17
turkey 16
saudi arabia 12
kenya 10
south africa 9
pakistan 9
jordan 9
austria 9
czechia 8
costa rica 8
panama 6
ukraine 4
myanmar 4
uzbekistan 3
iceland 3
tunisia 2
oman 2
lithuania 2
kazakhstan 2
italy 2
new zeland 1
moldova 1
lebanon 1
kyrgzstan 1
iraq 1
greece 1
ghana 1
bulgaria 1
armenia 1
albania 1

ChangeLog

2022-09-1 : Add 3 Teams => Costa Rica , Wales , Australia

2022-10-31 : Add api Matches by date date