SoccersAPIDocsv2.2
Docs/Guides

Interactive API Explorer

Every operation lists its plan families. Include tables show the effective plans on that operation, while example requests have their own plan label. The full dropdown contains supported combinations, not your account's permissions: Broadcast cannot request events or general match details, and Odds cannot request TV datasets or general match details. See Plans and Data Access.

The reference lets you send real requests to the API from the browser. Every call goes straight to api.soccersapi.com with your own credentials, so the responses are exactly what your application will receive.

1. Enter your credentials

Open Authentication at the top of the reference. Query authentication (ApiKeyQuery) is selected by default: enter your API key as the credential value, replacing the API_KEY placeholder. The client adds it to the URL as api_key.

Alternatively, select Bearer authentication (BearerAuth) and enter the same key without the Bearer prefix; the client adds it to the Authorization header instead of the URL.

On the first visit, the documentation asks whether to keep the credential only for the current session or remember it in this browser. Choose Credentials: session only on shared devices. If you opt in, Scalar stores the selected authentication values in the browser's local storage so they survive a reload; use the Credentials control in the header to change the choice later. The values are sent to SoccersAPI only when you explicitly run a request. Use a development key from admin.soccersapi.com/api-tokens.

The legacy user + token option is deprecated and provided only for existing integrations. See Authentication methods to migrate. Select one method per request.

2. Pick the operation

Open a route in the sidebar, for example Fixtures, and choose the operation you need, such as Match by ID or Fixtures by date. Each operation page shows only the parameters that apply to it; the t value is already part of the request. The route header above the operations keeps the full operations table, the include values and the request examples of the route.

3. Send the request

Press Send. The response panel shows the HTTP status, the response time and the JSON body. The Examples selector in the response section shows a captured response for each t value, so you can see the shape before calling.

4. Copy the request

The code snippet next to the request is generated for the selected client. The available clients include cURL, JavaScript, Node.js, Python, PHP, Java, C#, Go and Ruby. Remove credentials before sharing generated code. See Code Examples for complete placeholder-only samples.

Notes

Read in the reference