Documentation
REST API
Eight paginated endpoints for application integrations. A current API trial or subscription is required; a free account alone does not include API keys.
Authentication and key lifetime
Authorization: Bearer drb_your_api_key_hereCreate and revoke keys at /api-subscribers. Keys are shown once. Trial keys last 3 days; Lite keys 14 days; Elite keys 14 or 28 days; Flite and Touchline Pro keys 28 days. Access also depends on current product entitlement. Every key on an account shares the same daily request allowance.
Endpoints
Base URL: https://dribble360.com/api/v1. Use GET. Pagination defaults to limit=1000 and offset=0, with a maximum of 10,000 rows per request. Stop when rows.length < limit. Offsets must be nonnegative integers.
/api/v1/playersPlayer identities and available biography. Biography access differs between API and BigQuery tiers.
Supports limit and offset.
/api/v1/teamsTeam identities, names, slugs, and available competition context.
Supports limit and offset.
/api/v1/matchesFixtures, recorded results, status, and season linkage. Unplayed fixtures must not be counted as completed matches.
Supports limit and offset.
/api/v1/transfersOpta club movements archived on 17 September 2026, with start dates through 15 May 2026. Collection is paused across CSV, REST and BigQuery.
Supports limit and offset.
/api/v1/managersManager assignments by match and team; not the manager entity directory.
Supports limit and offset.
/api/v1/refereesOfficials and their match roles, cards, fouls, and available decisions. VAR data depends on the official’s role and source coverage.
Supports limit and offset.
/api/v1/player_matchesPlayer appearance statistics, including minutes and available attacking, passing, defensive, and goalkeeper metrics. Zero-minute squad records can occur.
Set season explicitly, for example 2025/2026 or 2025; the compatibility default is 2025/2026. Supports limit and offset.
/api/v1/team_matchesTeam performance statistics and home/away side. For goals against and match outcomes, use match scores with side rather than the legacy goals_conceded metric.
Set season explicitly, for example 2025/2026 or 2025; the compatibility default is 2025/2026. Supports limit and offset.
The managers and referees REST endpoints return match assignments. BigQuery also exposes separate entity tables with those names. Player biography fields (date_of_birth, height, weight, foot) require Flite. The player-match response includes assists as an alias of goal_assist.
Example request
curl -G https://dribble360.com/api/v1/player_matches -H "Authorization: Bearer drb_your_api_key_here" --data-urlencode "season=2025/2026" --data-urlencode "limit=100" --data-urlencode "offset=0"Responses contain dataset, season, limit, offset, count, rows, and refresh. The refresh object records cadence_hours, last_refreshed_at, and next_refresh_at. These describe publication of the product snapshot. Transfers also return collection.status: archived and X-Data-Collection-Status: archived; their source collection is paused.
Quotas and refresh schedules
Request quotas reset at midnight UTC. Authorized requests return X-RateLimit-Limit and X-RateLimit-Remaining. Data responses include X-Data-Refresh-Cadence-Hours, X-Data-Last-Refreshed-At, and, when recorded, X-Data-Next-Refresh-At.
Daily data publishes after completed ingestion. Lite reads a separate 72-hour snapshot. This is post-match data, not a live feed or a source of confirmed starting lineups before kickoff. Check the returned timestamps and relevant match dates before treating data as current.
Errors
400: invalid pagination or an invalid season label. 401: missing, revoked, expired, or unentitled key. 404: unknown dataset. 429: account quota reached. 503: data has not completed its initial publication. Query failures return 500. Correct request errors before retrying; use bounded backoff for service errors.