Skip to navigation
Embeds

Origins, attribution and limits

Where an embed key works, how fast changes reach live widgets, and what every plan shows.

Origins

An origin is a scheme and host, as the browser’s address bar shows it, with no path. A key works only on the origins you list for it, from 1 to 10 per key.

You listIt allows
https://example.comThat host only. https://www.example.com is a different origin.
https://*.example.comEvery subdomain, at any depth: https://www.example.com, https://news.example.com, https://live.news.example.com. Not https://example.com itself, so list both.
http://localhost:3000Your machine on that port, while you build. The port is required.

The portal lower-cases each origin, drops a trailing slash and converts a Unicode host to its ASCII form, so https://bücher.de is stored as https://xn--bcher-kva.de. It marks a row that repeats another, after those changes, as already listed, so remove the duplicate before you save.

These are refused:

OriginWhy
http://example.comUse https. Only localhost may use http.
http://127.0.0.1:3000Use http://localhost:3000.
http://localhostAdd the port.
https://example.com:8443https origins use the default port, so leave it out.
https://example.com/blogAn origin has no path.
https://intranet, https://localhostThe host needs at least two labels, such as example.com.
https://*.comA wildcard needs a domain after it.
https://*.co.uk, https://*.vercel.app, https://*.github.ioA wildcard can’t cover a public suffix, a domain anyone can register under. List your own domain, such as https://*.yoursite.co.uk.
https://www.*.example.com, https://*.*.example.comA wildcard goes only at the start, once.
https://statpad.dev, https://*.statpad.devStatpad’s own hosts. For iframes and apps, use the hosted page switches instead.

The portal marks a refused origin on its row and says why.

How fast changes take effect

Statpad caches a key’s settings in a few places for short times, so a change to the key reaches pages within a few minutes, not at once:

ChangeReaches the page
Add an originNew page loads, and open widgets that showed Not available on this site, within a few minutes, without a reload.
Remove an origin, or revoke the keyOpen widgets and hosted pages stop within a few minutes.
Turn a hosted page switch on or offNew hosted page loads within a few minutes. Open hosted pages that relied on it stop within a few minutes.

A scores list pinned to a past day, such as date="2026-11-09", whose games are all final, is the one exception. That answer can’t change, so Statpad caches it for an hour, and a site you removed can keep showing it for up to an hour.

Revoking a key can’t be undone. Its widgets show Embed key revoked, and your other embed keys and your API keys keep working. To move a site to a new key, create the new key, update the page, then revoke the old one.

When your account loses active access, such as when the trial ends without a subscription, its widgets show Not included until access returns.

Attribution

Every widget has a footer with up to two lines:

  • Not affiliated with any league or team. It shows on every plan.
  • Powered by Statpad, which links to statpad.dev. It shows on every plan except Business.
PlanNot affiliated linePowered by Statpad
Pro trialShownShown
DeveloperShownShown
ProShownShown
BusinessShownLeft out

The widget reads your plan with its data, so the line goes within a few minutes of your account moving to Business. Don’t hide, cover or restyle either line. Section 17 of the Terms covers what you may and may not do with widgets.

Leagues

Widgets cover football and basketball:

LeagueAliasSport
National Football LeaguenflFootball
NCAA Division I FBS FootballncaafFootball
National Basketball AssociationnbaBasketball
NCAA Division I Men’s BasketballncaabBasketball
Women’s National Basketball AssociationwnbaBasketball

A widget shows only leagues your account holds. A league it doesn’t hold answers no_access, which shows as Not included. Hockey and soccer aren’t covered yet: for a hockey or soccer league your account holds, a widget gets not_found, which shows as League not available in a scores list and Game not found in a scoreboard.

What each sport shows:

  • Football: a helmet in each team’s colours, the team with the ball, and during play the down and distance and the ball’s spot. The expanded scoreboard adds timeouts, the red zone and the last play, labelled when it’s a Touchdown, Field goal, Safety, Interception or Fumble.
  • Basketball: a disc in each team’s colours, and which team is in the bonus. The expanded scoreboard adds each team’s fouls and timeouts left.

The clock is the game clock as of the last play. It doesn’t tick between updates.

Limits

LimitValue
Active embed keys per account5, on every plan. Revoked keys don’t count.
Origins per key1 to 10
ViewsCounted per widget load and shown on the Embeds page. Not capped, and never charged.
Request allowance, rate and streamsEmbeds use none of them.
Days a scores list can show2026-08-01 to 14 days after today
max on a scores list100
How often a widget checksAbout every 4 seconds while a game is live, 30 seconds before, 60 once final

Creating a sixth key fails with You have 5 embed keys, the most an account can have. An account without an active plan can’t create embed keys.

Statpad throttles traffic that reaches it at an unusual rate, from one address or for one key. A throttled widget gets rate_limited, keeps its last data up and tries again.

Error codes

A widget reports these in statpad-error and shows the matching message.

CodeStatusMeaningFix
origin_not_allowed403The page’s origin isn’t on the key.Add the origin to the key.
key_revoked403The key was revoked.Create a new key and update the page.
no_access403The account has no active plan, or doesn’t hold the league.Subscribe, or use a league your plan includes.
key_unknown404No embed key has this value.Copy the key again from the Embeds page.
not_found404No such game or league, or a league your account holds that embeds don’t cover.Check league and game.
invalid_request400A missing or malformed key, league or game, or a date out of range.Check the attributes.
rate_limited429Too many requests from one address, or for one key.None. The widget retries.
unavailable503Statpad couldn’t answer.None. The widget retries.
networkNo answer within 10 seconds.None. The widget retries.
invalid_responseAn answer the widget couldn’t read.None. The widget retries.

A hosted page’s checks can also stop it with these, shown as Not available on this site:

CodeMeaningFix
iframes_offThe page is in an iframe and the key doesn’t allow iframes.Turn on Iframes on these sites.
apps_offThe page is in an app and the key doesn’t allow apps.Turn on Mobile apps.
parent_unknownThe page can’t tell which site is framing it.See Referrer-Policy.