GBVision
GBVision
Back to main hub
API Console · Customer Guide
Customer 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. This guide walks through each area of the console.

01 Signing 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.

Match selection Links Match database Stats Profile
API Console sign-in screen
API Console sign-in screen

02 Match 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 project from the top tabs or the side menu. Each language and coverage type is its own project.
  2. Tick the matches you want in the selection table, then press Save. This pre-selects them for review. Pre-selected matches are not yet confirmed or ordered.
  3. Place a firm order with Confirm. This actually orders the selected matches and generates their streaming links.
  4. Wait a few seconds. Links are generated and everything is prepared. Please do not refresh the browser during this step.
  5. Ordered fixtures appear in Confirmed matches. Their 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

04 Match 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 month
Matches commented
This year
Matches commented
All time
Matches commented
Found
For 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

05 Stats & 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.