GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

General Sport APIs - City IDs in Venue Objects

We've added a city_id unique identifier to all venue objects across our General Sport Media APIs. The new field is included alongside the existing city_name field and is available in all feeds that contain venue information.

This is a non-breaking enhancement to existing responses.

"city_name": "Liverpool",
"city_id": "sr:city:31",

Benefit

Use a city's unique identifier for entity linking, data enrichment, and cross-feed correlation wherever venue information is available.


☑️ Sample Requests:

Soccer - Competitor Profile

curl --request GET \
     --url https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/profile.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 APIs & Versions

Ball Sports

Individual Sports

Other Sports


🔁 Affected Endpoints

Competitor Feeds

  • Competitor Profile
  • Competitor Schedules
  • Competitor Summaries
  • Competitor vs Competitor

Player Feeds

  • Player Schedules
  • Player Summaries

Schedule & Summary Feeds

  • Daily Schedules
  • Daily Summaries
  • Live Schedules
  • Live Summaries
  • Season Schedules
  • Season Summaries

Sport Event Feeds

  • Sport Event Summary
  • Sport Event Timeline
  • Sport Event Extended Summary
  • Sport Event Extended Timeline
  • Sport Event Lineups
  • Sport Event Momentum
  • League Timeline

Probability Feeds

  • Season Probabilities
  • Live Probabilities
  • Sport Event Probabilities
  • Timeline Probabilities

⚙️ Return Samples

<venue id="sr:venue:8117" name="Dodger Stadium" capacity="56000" city_name="Los Angeles, CA" city_id="sr:city:963" country_name="USA" map_coordinates="34.0745409, -118.2408881" country_code="USA" timezone="America/Los_Angeles"/>
"venue": {
    "id": "sr:venue:8117",
    "name": "Dodger Stadium",
    "capacity": 56000,
    "city_name": "Los Angeles, CA",
    "city_id": "sr:city:963",
    "country_name": "USA",
    "map_coordinates": "34.0745409, -118.2408881",
    "country_code": "USA",
    "timezone": "America/Los_Angeles"
},