NEP provides HLS streaming of matches in OBOS-ligaen and Eliteserien for Fotball Media and its partners. The stream is default HLS v4 with multi audio tracks. However, the stream can be fetched in HLS v3 by tweaking the manifest URL. See examples below.
This guide will show you how to test the signals and how to fetch the correct stream_url for the match.
What you need
- The FIKS match id for the match you want to find the manifest for
- A REST client that can do REST calls
- An API token from NEP (after agreement with Fotball Media is confirmed)
To obtain the manifest URL, a REST call to our Gateway service is needed. The API endpoint is located at https://gateway-api-eu1.mediabank.me/live/event/
Request Query parameters: “fiksid” – number (The official match ID from FIKS)
- “tags-api-token” – string (API token provided by NEP)
- “accept” – “application/json”
Example query using curl (token needs to be changed):
curl "https://gateway-api-eu1.mediabank.me/live/event/?fiksid=7962705" \
-H "accept: application/json" \
-H "tags-api-token: TOKEN"
"event_name": "Sarpsborg 08 - Viking, Part 1",
"stream_start": "2022-04-03 17:50:00",
"stream_end": "2022-04-03 20:00:00",
How to test signals and stream the match
The manifest URL can be found in “stream_url”. Please note that the URL will return HTTP code 404 until the stream has been verified and published on our end, this happens at the latest 1 hour prior to kick-off.
"stream_start" is the time when the streaming starts from the arena.
For testing purposes, please use "source_url", this is available when the stream HLS URL is published, at the latest 1 hour prior to kick-off.
It is important that the "stream_url" is used when streaming the actual match.
After “stream_end” the asset will be a VoD asset for about a week.
How to use HLS v3 – audio settings
To force the stream to use HLS v3, add these parameters to the returned stream url:
Example v3 URL: https://l2v-cdn.nep.ms/mbrec/ES_Sarpsborg_08__Viking_Part_1__Multilateral.m3u8?audio=ina&mux_audio
How to find the FIKS ID
The FIKS ID can be found through our TAGS API. The same token used to fetch the HLS URL above can be used to access this.
You use the same token as for the HLS URL and run a query in our TAGS API for any matches in a specific domain ID (3045 for Eliteserien 2022) under “QueryHappenings” and query a date, for example – https://api-eu1.mediabank.me/tagsapi/doc/#api-Happening-QueryHappenings
You then find the internal match ID in the response and go to “Get Happening” - https://api-eu1.mediabank.me/tagsapi/doc/#api-Happening-GetHappening
Use that internal match ID to search, and you will then have the FIKS ID in the response under “externalid” or “matchId”.
How to manually find the FIKS ID
To manually find the FIKS ID, go to for example the Norwegian Football Association’s official schedule - https://www.fotball.no/fotballdata/turnering/terminliste/?fiksId=181484 – and click on the match you need in the column where it says “Kampnr.”, see example below.
Then you find the FIKS ID in the URL: