Technology
API CONSOLE GUIDE

Ordering live audio commentary

The GBVision API Console is your self-service hub for live audio commentary. From one place you can order matches, pull the HLS stream links for each fixture, browse the full match database and history, and review detailed listener statistics for every broadcast.

01Signing in

Open the console and sign in with the username and password we provide. Each account is scoped to your projects, so you only see the coverage, links and statistics that belong to you. The left-hand menu gives you the five working areas: Match selection, Links, Match database, Stats and Profile.

AreaMatch selection
AreaLinks
AreaMatch database
AreaStats
AreaProfile
API Console sign-in screen
API Console sign-in screen

02Match selection & ordering

This is where you choose and order commentary. Start by picking the project you want to draw matches from. In English we usually run two separate projects, because for the English Premier League and Championship we add a disclaimer clarifying that the commentary is not official.

  1. Pick a projectUse the top tabs or the side menu. Each language and coverage type is its own project.
  2. Tick the matches and press SaveThis pre-selects them for review. Pre-selected matches are not yet confirmed or ordered.
  3. Place a firm order with ConfirmThis actually orders the selected matches and generates their streaming links.
  4. Wait a few secondsLinks are generated and everything is prepared. Please do not refresh the browser during this step.
  5. Find your fixtures in Confirmed matchesTheir links are immediately available in the Feeds and under the Links tab for manual pairing if needed.
Save vs Confirm: Save only keeps your selection highlighted for later, it does not pair or order anything. Confirm is the firm order: once confirmed, the matches are booked and you receive the links.

You can also leave a message with your selection, for example a special request for a fixture, before confirming.

Match selection: tick fixtures, Save to pre-select, Confirm to order
Match selection: tick fixtures, Save to pre-select, Confirm to order

04Match database

The Match database is your full fixture list and history. Filter by date range and project, then browse every match with date, time, league, teams and language. The summary tiles at the top give you the volume of commentary delivered.

This monthMatches commented
This yearMatches commented
All timeMatches commented
FoundFor current filter

Use it to confirm what has been covered, look back over past fixtures, or check upcoming scheduled coverage across all your projects.

Match database: filter by date and project, with coverage totals
Match database: filter by date and project, with coverage totals

05Stats & commentary metrics

The Stats area reports how your broadcasts performed. The Stats report lists every match with its project, league, teams, language, listeners (total and unique) and average session length. Search, filter by date range or project, and export any row.

Match IDLeagueMatchLanguageListeners (total / unique)Avg session
5438782Championship PlayoffHull City vs MiddlesbroughEnglish15,570 / 8,38800:12:10
5206177Europa LeagueFreiburg vs Aston VillaEnglish16,352 / 10,28000:12:15
Stats report: listeners, unique listeners and average session length per match
Stats report: listeners, unique listeners and average session length per match

Per-match metrics

Open Metrics on any match for a detailed breakdown across four views:

Time series

Concurrent listeners across the match, so you can see kick-off, halftime and full-time peaks live.

Geospatial

A map of where your listeners tuned in from, by city, for the most popular locations.

National

Listener split by country with share percentages, ranked from your biggest market down.

Devices

Breakdown by platform (Android, iOS, web and more) to see how your audience listens.

Time series: concurrent listeners across the match
Time series: concurrent listeners across the match
Geospatial: listener locations on a map
Geospatial: listener locations on a map
National: listeners by country with share
National: listeners by country with share
Devices: listeners by platform
Devices: listeners by platform
Export: any match in the Stats report can be exported for your own reporting.

Let’s bring live sports audio to your platform.

Tell us what you are building and we’ll explore the right solution together.

Request a demo