Docs menu

Flashscore API endpoint

Flashscore match predicted lineups API

Returns each side's predicted formation, predicted starters with position tags and player details, lineup groups, and coaches. Predictions usually appear shortly before kickoff for covered matches; a match with no predicted players on either side returns not found.

GETapiKey1 credit/requestFlashscoreflashscore.matchPredictedLineupsResponseDoc/flashscore/match-predicted-lineups

Endpoint facts

Method: GET
API path: /flashscore/match-predicted-lineups
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Flashscore
Response schema: #/definitions/flashscore.matchPredictedLineupsResponseDoc

Flashscore scraping API Try Flashscore match predicted lineups API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

id (required): eight-character match id from a Flashscore match URL, for example f75igXFG.

Returns one entry per side (home, then away) with Flashscore's predicted lineup:

formation: name such as 4-2-3-1 and lines[].rows[], where each row lists player_ids (row sort_key 0 is the goalkeeper). It is null when no formation is predicted.
players: predicted starters with id, name, list_name, number, roles (title and suffix, for example Goalkeeper (G)), country (nationality), slug, age, height_cm, market_value (the provider's estimate; its currency is not stated) and average_rating.
groups: named player groups such as PREDICTED_STARTERS.
coaches: the listed coaches.
aggregated_stats: team averages when available.

Predictions are usually published shortly before kickoff for covered matches. When neither side has any predicted players (even if coaches are listed) the endpoint returns 404; if only one side has a prediction, the other side has empty players. Use /api/v1/flashscore/match-lineups for confirmed lineups. An unknown match id returns 404.

Example response (shortened):

{"code":200,"msg":"OK","data":{"source_url":"https://2.ds.lsapp.eu/pq_graphql?_hash=dplie&eventId=f75igXFG&projectId=2","match_id":"f75igXFG","teams":[{"participant_id":"2FbjCJan","side":"home","name":"Bragantino","formation":{"name":"4-2-3-1","lines":[{"number":1,"rows":[{"sort_key":0,"player_ids":["x2zyKcHK"]}]}]},"players":[{"id":"x2zyKcHK","name":"Tiago Volpi","list_name":"Tiago Volpi","number":"18","roles":[{"title":"Goalkeeper","suffix":"(G)"}],"country":"Brazil","slug":"tiago-volpi","age":35,"height_cm":189,"market_value":880751,"average_rating":7}],"groups":[{"type":"PREDICTED_STARTERS","name":"Predicted lineups","player_ids":["x2zyKcHK"]}],"coaches":[{"id":"t8jYQ9nT","name":"Vagner Mancini","list_name":"Vagner Mancini","country":"Brazil","slug":"vagner-mancini"}],"aggregated_stats":{"average_rating":6.7,"average_height_cm":181.1,"average_age":26.6,"sum_market_value":47598854}}]}}

Live monitoring

Monitored request: GET /flashscore/match-predicted-lineups?id=j52jHsN8
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.89 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/match-predicted-lineups?id=j52jHsN8
Items in teams: 2
Fields filled in every checked item: 7

Field	Filled in, of 2 checked	Values in the sample
participant_id	2
side	2	“home” and 1 other value
name	2	“Brighton” and 1 other value
formation	2
players	2	median 11 entries
groups	2	median 1 entry
coaches	2	median 1 entry

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Eight-character Flashscore match id	f75igXFG
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-predicted-lineups?id=f75igXFG" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://2.ds.lsapp.eu/pq_graphql?_hash=dplie&eventId=f75igXFG&projectId=2",
    "match_id": "f75igXFG",
    "teams": [
      {
        "participant_id": "2FbjCJan",
        "side": "home",
        "name": "Bragantino",
        "formation": {
          "name": "4-2-3-1",
          "lines": [
            {
              "number": 1,
              "rows": [
                {
                  "sort_key": 0,
                  "player_ids": [
                    "x2zyKcHK"
                  ]
                }
              ]
            }
          ]
        },
        "players": [
          {
            "id": "x2zyKcHK",
            "name": "Tiago Volpi",
            "list_name": "Tiago Volpi",
            "number": "18",
            "roles": [
              {
                "title": "Goalkeeper",
                "suffix": "(G)"
              }
            ],
            "country": "Brazil",
            "slug": "tiago-volpi",
            "age": 35,
            "height_cm": 189,
            "market_value": 880751,
            "average_rating": 7
          }
        ],
        "groups": [
          {
            "type": "PREDICTED_STARTERS",
            "name": "Predicted lineups",
            "player_ids": [
              "x2zyKcHK"
            ]
          }
        ],
        "coaches": [
          {
            "id": "t8jYQ9nT",
            "name": "Vagner Mancini",
            "list_name": "Vagner Mancini",
            "country": "Brazil",
            "slug": "vagner-mancini"
          }
        ],
        "aggregated_stats": {
          "average_rating": 6.7,
          "average_height_cm": 181.1,
          "average_age": 26.6,
          "sum_market_value": 47598854
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.matchPredictedLineupsResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	flashscore.matchPredictedLineupsDataDoc	No
data.match_id	string	No		f75igXFG
data.source_url	string	No		https://2.ds.lsapp.eu/pq_graphql?_hash=dplie&eventId=f75igXFG&projectId=2
data.teams	array	No
data.teams[].aggregated_stats	flashscore.lineupAggregatedStatsDoc	No
data.teams[].aggregated_stats.average_age	number	No		26.6
data.teams[].aggregated_stats.average_height_cm	number	No		181.1
data.teams[].aggregated_stats.average_rating	number	No		6.7
data.teams[].aggregated_stats.sum_market_value	number	No		47598854
data.teams[].coaches	array	No
data.teams[].coaches[].age	number	No		35
data.teams[].coaches[].average_rating	number	No		7
data.teams[].coaches[].country	string	No		Brazil
data.teams[].coaches[].height_cm	number	No		189
data.teams[].coaches[].id	string	No		x2zyKcHK
data.teams[].coaches[].list_name	string	No		Tiago Volpi
data.teams[].coaches[].market_value	number	No		880751
data.teams[].coaches[].name	string	No		Tiago Volpi
data.teams[].coaches[].number	string	No		18
data.teams[].coaches[].roles	array	No
data.teams[].coaches[].roles[].suffix	string	No		(G)
data.teams[].coaches[].roles[].title	string	No		Goalkeeper
data.teams[].coaches[].slug	string	No		tiago-volpi
data.teams[].formation	flashscore.predictedFormationDoc	No
data.teams[].formation.lines	array	No
data.teams[].formation.lines[].number	integer	No		1
data.teams[].formation.lines[].rows	array	No
data.teams[].formation.lines[].rows[].player_ids	array	No		x2zyKcHK
data.teams[].formation.lines[].rows[].sort_key	integer	No		0
data.teams[].formation.name	string	No		4-2-3-1
data.teams[].groups	array	No
data.teams[].groups[].name	string	No		Predicted lineups
data.teams[].groups[].player_ids	array	No		x2zyKcHK
data.teams[].groups[].type	string	No		PREDICTED_STARTERS
data.teams[].name	string	No		Bragantino
data.teams[].participant_id	string	No		2FbjCJan
data.teams[].players	array	No
data.teams[].players[].age	number	No		35
data.teams[].players[].average_rating	number	No		7
data.teams[].players[].country	string	No		Brazil
data.teams[].players[].height_cm	number	No		189
data.teams[].players[].id	string	No		x2zyKcHK
data.teams[].players[].list_name	string	No		Tiago Volpi
data.teams[].players[].market_value	number	No		880751
data.teams[].players[].name	string	No		Tiago Volpi
data.teams[].players[].number	string	No		18
data.teams[].players[].roles	array	No
data.teams[].players[].roles[].suffix	string	No		(G)
data.teams[].players[].roles[].title	string	No		Goalkeeper
data.teams[].players[].slug	string	No		tiago-volpi
data.teams[].side	string	No	home, away	home
msg	string	No		OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-predicted-lineups?id=f75igXFG" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Flashscore endpoint docs Flashscore scraping API Flashscore calendar categories API documentation Flashscore season calendar API documentation Flashscore Competitions API documentation Flashscore Entity News API documentation Flashscore match box score API documentation Flashscore match darts API documentation

Open in Playground Back to group

Docs menu

Flashscore API endpoint

Flashscore match predicted lineups API

GETapiKey1 credit/requestFlashscoreflashscore.matchPredictedLineupsResponseDoc/flashscore/match-predicted-lineups

Endpoint facts

Method: GET
API path: /flashscore/match-predicted-lineups
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Flashscore
Response schema: #/definitions/flashscore.matchPredictedLineupsResponseDoc

Flashscore scraping API Try Flashscore match predicted lineups API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

id (required): eight-character match id from a Flashscore match URL, for example f75igXFG.

Returns one entry per side (home, then away) with Flashscore's predicted lineup:

formation: name such as 4-2-3-1 and lines[].rows[], where each row lists player_ids (row sort_key 0 is the goalkeeper). It is null when no formation is predicted.
players: predicted starters with id, name, list_name, number, roles (title and suffix, for example Goalkeeper (G)), country (nationality), slug, age, height_cm, market_value (the provider's estimate; its currency is not stated) and average_rating.
groups: named player groups such as PREDICTED_STARTERS.
coaches: the listed coaches.
aggregated_stats: team averages when available.

Example response (shortened):

{"code":200,"msg":"OK","data":{"source_url":"https://2.ds.lsapp.eu/pq_graphql?_hash=dplie&eventId=f75igXFG&projectId=2","match_id":"f75igXFG","teams":[{"participant_id":"2FbjCJan","side":"home","name":"Bragantino","formation":{"name":"4-2-3-1","lines":[{"number":1,"rows":[{"sort_key":0,"player_ids":["x2zyKcHK"]}]}]},"players":[{"id":"x2zyKcHK","name":"Tiago Volpi","list_name":"Tiago Volpi","number":"18","roles":[{"title":"Goalkeeper","suffix":"(G)"}],"country":"Brazil","slug":"tiago-volpi","age":35,"height_cm":189,"market_value":880751,"average_rating":7}],"groups":[{"type":"PREDICTED_STARTERS","name":"Predicted lineups","player_ids":["x2zyKcHK"]}],"coaches":[{"id":"t8jYQ9nT","name":"Vagner Mancini","list_name":"Vagner Mancini","country":"Brazil","slug":"vagner-mancini"}],"aggregated_stats":{"average_rating":6.7,"average_height_cm":181.1,"average_age":26.6,"sum_market_value":47598854}}]}}

Live monitoring

Monitored request: GET /flashscore/match-predicted-lineups?id=j52jHsN8
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.89 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/match-predicted-lineups?id=j52jHsN8
Items in teams: 2
Fields filled in every checked item: 7

Field	Filled in, of 2 checked	Values in the sample
participant_id	2
side	2	“home” and 1 other value
name	2	“Brighton” and 1 other value
formation	2
players	2	median 11 entries
groups	2	median 1 entry
coaches	2	median 1 entry

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Eight-character Flashscore match id	f75igXFG
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-predicted-lineups?id=f75igXFG" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://2.ds.lsapp.eu/pq_graphql?_hash=dplie&eventId=f75igXFG&projectId=2",
    "match_id": "f75igXFG",
    "teams": [
      {
        "participant_id": "2FbjCJan",
        "side": "home",
        "name": "Bragantino",
        "formation": {
          "name": "4-2-3-1",
          "lines": [
            {
              "number": 1,
              "rows": [
                {
                  "sort_key": 0,
                  "player_ids": [
                    "x2zyKcHK"
                  ]
                }
              ]
            }
          ]
        },
        "players": [
          {
            "id": "x2zyKcHK",
            "name": "Tiago Volpi",
            "list_name": "Tiago Volpi",
            "number": "18",
            "roles": [
              {
                "title": "Goalkeeper",
                "suffix": "(G)"
              }
            ],
            "country": "Brazil",
            "slug": "tiago-volpi",
            "age": 35,
            "height_cm": 189,
            "market_value": 880751,
            "average_rating": 7
          }
        ],
        "groups": [
          {
            "type": "PREDICTED_STARTERS",
            "name": "Predicted lineups",
            "player_ids": [
              "x2zyKcHK"
            ]
          }
        ],
        "coaches": [
          {
            "id": "t8jYQ9nT",
            "name": "Vagner Mancini",
            "list_name": "Vagner Mancini",
            "country": "Brazil",
            "slug": "vagner-mancini"
          }
        ],
        "aggregated_stats": {
          "average_rating": 6.7,
          "average_height_cm": 181.1,
          "average_age": 26.6,
          "sum_market_value": 47598854
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.matchPredictedLineupsResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	flashscore.matchPredictedLineupsDataDoc	No
data.match_id	string	No		f75igXFG
data.source_url	string	No		https://2.ds.lsapp.eu/pq_graphql?_hash=dplie&eventId=f75igXFG&projectId=2
data.teams	array	No
data.teams[].aggregated_stats	flashscore.lineupAggregatedStatsDoc	No
data.teams[].aggregated_stats.average_age	number	No		26.6
data.teams[].aggregated_stats.average_height_cm	number	No		181.1
data.teams[].aggregated_stats.average_rating	number	No		6.7
data.teams[].aggregated_stats.sum_market_value	number	No		47598854
data.teams[].coaches	array	No
data.teams[].coaches[].age	number	No		35
data.teams[].coaches[].average_rating	number	No		7
data.teams[].coaches[].country	string	No		Brazil
data.teams[].coaches[].height_cm	number	No		189
data.teams[].coaches[].id	string	No		x2zyKcHK
data.teams[].coaches[].list_name	string	No		Tiago Volpi
data.teams[].coaches[].market_value	number	No		880751
data.teams[].coaches[].name	string	No		Tiago Volpi
data.teams[].coaches[].number	string	No		18
data.teams[].coaches[].roles	array	No
data.teams[].coaches[].roles[].suffix	string	No		(G)
data.teams[].coaches[].roles[].title	string	No		Goalkeeper
data.teams[].coaches[].slug	string	No		tiago-volpi
data.teams[].formation	flashscore.predictedFormationDoc	No
data.teams[].formation.lines	array	No
data.teams[].formation.lines[].number	integer	No		1
data.teams[].formation.lines[].rows	array	No
data.teams[].formation.lines[].rows[].player_ids	array	No		x2zyKcHK
data.teams[].formation.lines[].rows[].sort_key	integer	No		0
data.teams[].formation.name	string	No		4-2-3-1
data.teams[].groups	array	No
data.teams[].groups[].name	string	No		Predicted lineups
data.teams[].groups[].player_ids	array	No		x2zyKcHK
data.teams[].groups[].type	string	No		PREDICTED_STARTERS
data.teams[].name	string	No		Bragantino
data.teams[].participant_id	string	No		2FbjCJan
data.teams[].players	array	No
data.teams[].players[].age	number	No		35
data.teams[].players[].average_rating	number	No		7
data.teams[].players[].country	string	No		Brazil
data.teams[].players[].height_cm	number	No		189
data.teams[].players[].id	string	No		x2zyKcHK
data.teams[].players[].list_name	string	No		Tiago Volpi
data.teams[].players[].market_value	number	No		880751
data.teams[].players[].name	string	No		Tiago Volpi
data.teams[].players[].number	string	No		18
data.teams[].players[].roles	array	No
data.teams[].players[].roles[].suffix	string	No		(G)
data.teams[].players[].roles[].title	string	No		Goalkeeper
data.teams[].players[].slug	string	No		tiago-volpi
data.teams[].side	string	No	home, away	home
msg	string	No		OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-predicted-lineups?id=f75igXFG" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Flashscore match predicted lineups API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Flashscore match predicted lineups API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related