FAQs

Coverage

What sports and leagues are available?

See the full coverage list for every sport and league in the GenAI Content API.

When is content available?

• Previews publish 2 days before match start.
• Recaps publish 30 minutes after match end.

When can I expect more sports and leagues to be added?

New sports and leagues are added close to their individual season start dates.

What languages are available?

All events are available in US English. Soccer previews and recaps additionally support UK English.

Integration

How do I obtain competition and sport event IDs to access the Soccer content?

GenAI Content Soccer requests require a competition ID and a sport event ID. Both are retrieved through the RESTful Sports APIs.

Sign up for a trial account, or log in to your existing account.

Retrieving competition IDs

A competition ID identifies a league or tournament (for example, the English Premier League) and stays the same from season to season. Use the table below for the competition IDs that map to each GenAI soccer league. For any league not yet listed, the competition ID is available from that sport's API documentation.

Retrieving sport event IDs

A sport event ID identifies a single match. Retrieve every sport event ID for a given competition and season from that sport's Season Schedule endpoint, which returns the full match list for one season.

Each request uses a season ID, not a competition ID. The competition ID is stable, but the season ID changes each year—so update the season ID in your call at the start of each new season. You can find the current season ID for a competition from the API's Seasons endpoint.

Soccer competitions

Retrieve the full match list (and every sport event ID) for a competition by calling the Soccer API's Season Schedule endpoint with the relevant season ID:

curl --request GET \
     --url https://api.sportradar.com/soccer/trial/v4/en/seasons/{season_id}/schedules.json \
     --header 'accept: application/json' \
     --header 'x-api-key: your_api_key'

Replace {season_id} with a value from the table below and {your_api_key} with your trial or production key. The competition ID stays the same year to year; the season ID changes each season.

📘

Season IDs change each year. Retrieve the current season ID for any competition from the Soccer API's Seasons endpoint.

How do I link the content to other Sportradar products?

All content is mapped to Sportradar IDs, so it drops cleanly into your existing data workflows with no manual reconciliation.

ID mappings can include sports, teams, seasons, games, competitions, players, venues, referees, and managers.

"references": {
    "sport": {
        "id": "sr:sport:1",
        "name": "Soccer"
    },
    "teams": [
        {
            "id": "sr:competitor:1644",
            "name": "Paris Saint-Germain"
        }
    ]
}

What format are the date/time fields presented in?

All date/time attributes are in UTC, presented in the ISO 8601 standard format.

Example: 2026-05-29T15:51:02Z

For more information, see the ISO 8601 standard.

How can I trial this product?

Create a free trial for World Cup content in your Marketplace account. If you’re interested in other soccer competitions or future sports, reach out to your sales representative.