BoxToBox API
Matching APICompetitions

Map competition IDs between providers

GET
/competitions

Translates competition ids from one provider (from) into one or many target providers (to). Up to 25 ids per request.

Provider keys:

  • transfermarkt (string ids)
  • wyscout
  • noisefeed
  • skillcorner
  • statsbomb
  • impect
  • sofascore
  • capology (string ids)
  • sportsinteractive
  • soccerway

Your token grants a subset of these providers; a from or to outside it is rejected with 401.

Example request: GET /competitions?ids=IT1,GB1,L1&from=transfermarkt&to=wyscout,statsbomb,skillcorner,sofascore&token=XXX

Query Parameters

ids*string

Comma-separated competition ids in the source provider (max 25)

from*string

Source provider key (single value, see the provider keys above)

to*string

Comma-separated target provider keys (see the provider keys above)

Response Body

application/json

application/json

application/json

Authorization

token
token<token>

In: query

curl -X GET "https://example.com/competitions?ids=string&from=string&to=string"
{  "matching": [    {      "name": "Cearense 1",      "short_name": "Cearense 1",      "area": "BRA",      "transfermarkt": "BRCE",      "wyscout": 227    }  ]}

Map coach IDs between providers GET

Translates coach/manager ids from one provider (`from`) into one or many target providers (`to`). Up to 100 ids per request. Covers managers/coaches only, not every staff role. Provider keys: - `transfermarkt` - `wyscout` Your token grants a subset of these providers; a `from` or `to` outside it is rejected with 401. Example request: GET /coaches?ids=28002&from=transfermarkt&to=wyscout&token=XXX

List seasons for a competition with provider keys GET

Returns the competition mapping (same shape as `/matching/competitions`) plus a `seasons` array, as a single bare object (not wrapped in `matching`). Each season carries the Transfermarkt key (`<competition_id>/<season_id>`), a display `name`, and the season key of every requested target provider that covers this competition. Seasons the requested target providers have no data for are left out. `from` defaults to `transfermarkt` when omitted. Target providers that carry season data: `wyscout`, `skillcorner`, `statsbomb`, `sofascore`, `impect`. Example request: GET /competitions/PL1/seasons?to=statsbomb,skillcorner&token=XXX