Push Events

Syntax

https://api.sportradar.com/soccer-extended/{access_level}/{version}/stream/events/subscribe?api_key={your_api_key}

Parameters

Parameter	Description
`access_level`	Defines the access level of your API key `production`, `trial`
`version`	Version number of the API `v4`
`your_api_key`	Your API key

Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

Optional query string parameters must be added after your API key with an ampersand (&). If you are filtering for more than one result, separate the results with a comma (,) and no spaces.

URL Parameters	Description
`competition_id`	Competition id Example: `competition_id=sr:competition:204`
`event_id`	Event type Example: `event_id=free_kick`
`format`	Format type Example: `format=json`
`season_id`	Season id Example: `season_id=sr:season:50039`
`sport_event_id`	Sport event id Example: `sport_event_id=sr:sport_event_id:13644241`

Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/soccer-extended/trial/v4/stream/events/subscribe?api_key={your_api_key}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

import requests
import json

r = requests.get("https://api.sportradar.com/soccer-extended/trial/v4/stream/events/subscribe",
    params = {'api_key': 'your_api_key'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L GET 'https://api.sportradar.com/soccer-extended/trial/v4/stream/events/subscribe?api_key={your_api_key}&format=json&sport_event_id=sr:match:13468929'

Samples with Query String Params

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/soccer-extended/trial/v4/stream/events/subscribe?api_key={your_api_key}&format=json&sport_event_id=sr:match:13468929")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

import requests
import json

r = requests.get("https://api.sportradar.com/soccer-extended/trial/v4/stream/events/subscribe",
    params = {'api_key': 'your_api_key', 'format': 'json', 'sport_event_id': 'sr:match:13468929'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L GET 'https://api.sportradar.com/soccer-extended/trial/v4/stream/events/subscribe?api_key={your_api_key}&format=json&sport_event_id=sr:match:13468929'

Response Sample

The above commands return json like this.