TIPERO Public API

Free JSON API for tennis predictions, results and stats — built for blogs, researchers, side projects and commercial integrations alike.

Free · No API key CORS enabled JSON · UTF-8 Read-only

Introduction

The TIPERO API exposes the same data that powers tipero.app/picks/today, the track record page and the embeddable widget. Every endpoint returns JSON over HTTPS — no API key required for read-only public data.

Base URL:

https://tipero2-auth-api.cevarooo.workers.dev

Authentication

Public read-only endpoints (the ones documented here) require no authentication. They're rate-limited but free for any reasonable use.

Premium endpoints (full daily board with confidence scores + Kelly stakes) require a session cookie obtained via /auth/login. For commercial syndication needs, see the commercial use section.

CORS & rate limits

All public endpoints send Access-Control-Allow-Origin: * — you can fetch them directly from any domain in the browser. Rate limit is currently soft (no enforced cap) but please don't abuse: the daily slate has at most 200-300 picks, so polling once per minute is overkill.

Recommended: cache responses on your end for 5-15 minutes. Picks update once daily at ~21:00 UTC; stats update once daily after grading.

/api/latest

GET/api/latest
Returns the latest published prediction run (today's picks). Includes both public picks (free) and a count of locked premium picks.
Example request
curl https://tipero2-auth-api.cevarooo.workers.dev/api/latest
Example response
{
  "ok": true,
  "run": {
    "run_date": "2026-04-25",
    "match_date": "2026-04-26",
    "published_at_utc": "2026-04-25T21:51:37Z"
  },
  "picks": [
    {
      "source_type": "public",
      "tour": "ATP",
      "match_date": "2026-04-26",
      "tournament": "Madrid",
      "surface": "clay",
      "player1": "Sinner J.",
      "player2": "Alcaraz C.",
      "display_match": "Sinner J. vs Alcaraz C.",
      "pick": "Sinner J.",
      "confidence": 58.2,
      "odds": 1.85,
      "tier": "VALUE",
      "is_locked": 0
    }
  ],
  "counts": { "playable": 8 }
}

/api/picks/{date}

GET/api/picks/{YYYY-MM-DD}
Returns all picks for a specific match date. Same structure as /api/latest.
Path parameters
ParamTypeDescription
datestringISO date YYYY-MM-DD (e.g. 2026-04-26)
Example request
curl https://tipero2-auth-api.cevarooo.workers.dev/api/picks/2026-04-26

/api/runs

GET/api/runs?limit=N
Lists recent published runs (each one corresponds to one match date).
Query parameters
ParamTypeDefaultDescription
limitinteger30Number of runs to return (max ~365)
Example request
curl https://tipero2-auth-api.cevarooo.workers.dev/api/runs?limit=14

/api/stats

GET/api/stats
Aggregate stats across all graded picks: profit, ROI, win rate, breakdown by tour.
Example response (truncated)
{
  "ok": true,
  "stats": {
    "all_time": {
      "total_bets": 416,
      "wins": 181,
      "losses": 235,
      "total_profit": 109.60,
      "total_staked": 405.20,
      "win_rate_pct": 43.5,
      "roi_pct": 27.0
    },
    "last_30_days": { ... },
    "by_tour": [ ... ]
  }
}

/api/results

GET/api/results?limit=N&offset=N&tour=ATP|WTA
Paginated list of all graded picks (full historical record). One row per bet placed.
Query parameters
ParamTypeDefaultDescription
limitinteger50Rows per page (max 200)
offsetinteger0Skip N rows (pagination)
tourstring—Filter to ATP or WTA

Embeddable widget

The simplest integration: drop a single iframe on your site to display today's free pick. See /embed for copy-paste code and live preview. Auto-updates daily, no maintenance.

Commercial use

The public API is free for any reasonable use including ad-supported and commercial sites. We only ask that you keep the visible "TIPERO" attribution intact when using the embeddable widget.

For high-volume integrations (thousands of requests per minute), white-labeled access without attribution, or premium-tier picks via API, contact us via the account system. Commercial deals are bespoke.

Want the full board on your account?

Premium subscribers see all 6-12 daily picks (free trial, no card).

Start 7-day Free Trial →