OleBall
OLEBALL PARTNERS

Partners welcome

Run a football website, blog, forum or app? Bring Oleball live scores to your community, for free.

Free to useLinks, not iframesYour site. Your audience.

Three ways to connect

Choose what works for your website. Every match links back to Oleball, so you can track clicks in your own analytics and we can see which partners send us readers.

The free JSON match feed

JSON

Today's matches, ready for your own design. The feed refreshes every 2 minutes, and browsers may read it straight from your own pages (CORS is open).

GET Public endpoint
https://oleball.com/api/public/matches

Already using this address? Nothing changes: it keeps working exactly as before.

Add your site's short name so we can count the visitors you send:

With your partner name
https://oleball.com/api/public/matches?partner=yoursite

Each match in the feed has

  • Names & languageleague, teamA, teamB: names (translated when you add &lang=, e.g. lang=es).
  • A direct match linkurl: the match page on Oleball, already tagged with your partner name. Please link each match to it.
  • Kickoff & scoreskickoffUtc, status (scheduled, live or ft), scoreA, scoreB.

The live score widget

HTML

Shows today's matches on your page with one line of HTML. The scores are written into your page, and every match links to its Oleball page.

Copy. Paste. You're connected.

Paste this where the scores should appear. Replace yoursite with a short name for your site.

Embed code · HTML
<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>

Please keep the "Live scores by Oleball" link visible. It is the only credit we ask for, and the widget keeps it under the match list.

Widget preview
Live scores by Oleball

Make it your own

Optional attributes for the live score widget
AttributeWhat it does
data-partnerYour site's short name (lower-case letters, numbers, - _ .). We use it to report the visitors you send us.
data-langTeam and league names in another language, e.g. fa, es, id, ar.
data-limitHow many matches to show (1–50, default 12).
data-leagueOnly show leagues whose name contains this text, e.g. Premier League.
data-themelight (default), dark, or auto to follow the reader's system setting.

Questions or a custom feed?

Let's find the right fit for your football community.

Contact the Oleball team