Live match widget
The match, live on your site. Two lines of HTML.
Drop a live match tracker into any page: the score and clock, the play drawn on the pitch as it happens, shots, corners and cards, stats and the timeline. It updates by itself until the final whistle, sizes to its column and takes your colours.
Included in PRO, MAX and ULTRA. No extra fee per viewer.
Want to try a look first? Open the customizer.
A made-up match playing on a loop: the same widget your visitors get with a real match.
Who can use it
The widget is part of the PRO, MAX and ULTRA plans, with an active subscription (a free trial counts). Your plan sets how many sites can show it. BASIC and STARTER do not include it.
- One site = a domain and its www. form.
example.comcoverswww.example.comtoo; another subdomain such aslive.example.comis a site of its own. - Testing locally? Register
localhostas one of your sites. - Downgrading never deletes anything. The sites you added first keep working; the rest pause until you upgrade again.
PRO
€79/mo
1
site with the widget
Plus everything else in PRO: the REST API, the live WebSocket and the Stream API.
MAX
€149/mo
2
sites with the widget
Plus everything else in MAX: the REST API, the live WebSocket and the Stream API.
ULTRA
€249/mo
3
sites with the widget
Plus everything else in ULTRA: the REST API, the live WebSocket and the Stream API.
Set it up in four steps
About five minutes from sign-in to a live match on your page.
Sign in and pick a plan in the dashboard. A new account can start PRO with a 7-day free trial, and the widget works during it.
Dashboard → Billing & planIn the dashboard's Live match widget section, press Create widget key. It is public and separate from your API key: keep the API key secret, put the widget key in your pages.
wk_8KqzP0…Type the address of each site that will show the widget: example.com, or localhost while you test. The widget shows nowhere else, so a copied key is no use to anyone.
example.com (covers www.example.com)Two lines where the tracker should go, with the match's id and your key. Changes in the dashboard reach the widget within a minute.
<script src="https://widget.pulsescore.net/widget.js" defer></script>
Find the match's id
The widget takes bet365's event id: the eventId of the match in the bet365 endpoints of the API. The same id is used before, during and after the match, so you can put the widget on a match page days ahead.
- Live now:
/api/v3/bet365/live-events?sport=soccer, any sport from/api/v3/bet365/live-events/sports. - Later today, this week: the prematch events of the sport, for example
/api/v3/bet365/soccer/eventsor one league's/api/v3/bet365/soccer/leagues/:league/events(see the bet365 reference). - Known from another bookmaker? Many bookmakers carry the match's Betradar id (
betradarId). Use it withbetradar-id="…"instead ofevent-id. Not every match has one, so prefer the bet365 id when you have it.
curl -H "x-secret: YOUR_API_KEY" \
"https://api.pulsescore.net/api/v3/bet365/live-events?sport=soccer&limit=30"{
"total": 74,
"events": [
{
"eventId": "204333720", ← event-id="204333720"
"home": "Arsenal",
"away": "Chelsea",
"league": "England Premier League",
...
}
]
}Examples to copy
Replace YOUR_WIDGET_KEY with the key from your dashboard and the id with your match's. The customizer writes this code for you as you pick a layout, colours and your own labels.
The script once per page, then the element where the match should go. It fills its column (320 to 620 px wide) and grows with the sport.
<script src="https://widget.pulsescore.net/widget.js" defer></script>
<pulse-tracker event-id="204333720" key="YOUR_WIDGET_KEY"></pulse-tracker>When it shows a match
The widget follows a match while it is live, from the first minute to the final score.
Before kick-off
The widget says the match is not live yet and connects by itself the moment it starts. A page left open more than 30 minutes before the start asks the visitor to reload.
Live
Score, clock, the play drawn as it happens, stats and the timeline, updated within seconds of the action.
Full time
The final score and stats stay on the card for visitors already watching.
Sports
Drawn on their own pitch, court, rink or board
- Soccer
- Basketball
- Tennis
- Volleyball
- Ice hockey
- Handball
- Water polo
- Darts
- American football
- Rugby
Scoreboard, stats and timeline
- Table tennis
- Badminton
- Esports
- Other sports
Not offered
- Horse racing
- Baseball
- Cricket
- Snooker
What the element tells your page
data-state on the element, and a bubbling pulse-tracker:state event with the same value.
| connecting | Opening the connection. |
| waiting | The match is not live yet; it appears when it starts. |
| live | The match is on. |
| ended | Full time. |
| timeout | Waited 30 minutes and the match did not start: reload to check again. |
| unavailable | This sport is not offered. |
| busy | Many viewers right now; the widget retries by itself. |
| error | The connection failed; the widget retries by itself. |
| denied | No valid key, a site that is not registered for it, or no PRO, MAX or ULTRA plan. detail.reason says which; the widget does not retry. |
Widget questions
Which plans include the live match widget?
PRO (1 site), MAX (2 sites) and ULTRA (3 sites). BASIC and STARTER do not include it. A site is a domain together with its www. form: example.com covers example.com and www.example.com.
Is the widget key secret?
No. The widget key is public by design: it sits in your page's HTML. It is a different key from your API key, which must stay secret, and it only works on the sites you registered for it in the dashboard. If you ever want a new one, Regenerate it in the dashboard; the old key stops working within a minute.
How do I get a match's id?
Use the eventId of the match from the bet365 endpoints of the PulseScore API, for example GET /api/v3/bet365/live-events?sport=soccer. The same eventId is used before, during and after the match, so you can place the widget before kick-off. A match known from another bookmaker can be shown by its Betradar id with betradar-id instead of event-id, when bet365 links the match to one.
When does the widget show a match?
While the match is live. Before kick-off it says the match is not live yet and connects by itself the moment it starts; a page left open for more than 30 minutes before the start asks the visitor to reload. At full time it keeps the final score and stats.
Which sports does the widget cover?
Soccer, basketball, tennis, volleyball, ice hockey, handball, water polo, darts, American football and rugby are drawn on their own pitch, court, rink or board. Table tennis, badminton, esports and other sports get the scoreboard, stats and timeline. Horse racing, baseball, cricket and snooker are not offered.
Can I use the widget on more sites?
Each plan has a number of sites: PRO 1, MAX 2, ULTRA 3. Upgrade to add more. Each subdomain other than www counts as its own site. For local testing, register localhost.
What happens to the widget if I downgrade or my payment fails?
Your key and your sites are kept. After a downgrade the sites you added first keep working and the others are paused until you upgrade again. On BASIC, STARTER or an unpaid subscription every site is paused, and visitors see a short message instead of the match.
Script tag or iframe: which should I use?
The script tag is the default: it sizes itself, takes your fonts and colours, and tells your page when the match is live. Use the iframe when your site does not allow scripts. The iframe only shows inside pages of your registered sites, so keep the page's Referer (do not set referrerpolicy=no-referrer on the frame).
How do I use the widget in React, Next.js or Vue?
Load widget.js once and render the pulse-tracker element. React and Vue keep a prop called key to themselves, so pass the widget key as widget-key there: it does the same as key.
Do widget viewers count against my API rate limits?
No. The widget is served by its own service: your visitors watching a match do not use your API requests or your WebSocket connections.
Can I change how the widget looks?
Yes. Theme (dark or light), compact or full stats, which tab opens first, which parts to hide, and every colour down to a colour per event and stat. The customizer at widget.pulsescore.net/customize shows them on a demo match and writes the code for you.
Can I change the widget's labels or show it in my language?
Yes. The labels attribute replaces any text on the card with your own words: events such as corners and penalties, the stats, the tabs, the period names and the messages. Write the English text, a colon and yours, for example labels="Corners: Cantos; Penalty: Penálti". The iframe takes the same text as ?labels=. The customizer has a field for every text and writes the code for you.
Put tonight's match on your site
Create your widget key, register your site and paste two lines. It works on any PRO, MAX or ULTRA plan, the free trial included.