Live football scores for your site

Bring free Oleball live scores to your website, blog, forum or app.

Choose an integration

Choose an integration

Each option links to Oleball so you can track referrals in your own analytics.

JSON match feed

The public feed refreshes every two minutes and supports cross-origin requests (CORS).

GET Public endpoint
https://oleball.com/api/public/matches
GET With referral tracking
https://oleball.com/api/public/matches?partner=yoursite

yoursite Replace this with a short name for your site.

Match fields

  • Team and league namesleague, teamA, teamBAdd a language parameter to translate names.&lang=es
  • Match linkurlUse this URL for each match. It includes your referral tag.
  • Kickoff and scoreskickoffUtc, scoreA, scoreBstatus scheduled, live, ft

Live score widget

Paste the HTML where you want today's matches to appear. Every match links to its Oleball page.

HTML embed code
<div class="oleball-scores" data-partner="yoursite">
  <a href="https://oleball.com/">Live scores by Oleball</a>
</div>
<script async src="https://oleball.com/widget.js"></script>

yoursite Replace this with a short name for your site.

Keep the Oleball credit link visible beneath the match list.

Widget preview

Widget options

AttributeDescription
data-partnerReferral name using lowercase letters, digits or these symbols. - _ .
data-langLanguage for team and league names. fa, es, id, ar
data-limitNumber of matches to show (1–50, default 12).
data-leagueShow leagues whose names contain the specified text. Premier League
data-themelight (default), dark, auto (follows the system theme)

Questions or need a custom feed?

Контакт

Copied Selected The snippet is selected. Press Ctrl+C or Command+C to copy.