balldontlie integration

balldontlie data, in your warehouse.

A built-in ingestr connector: add credentials, pick tables, schedule it.

name: raw.teams
type: ingestr
parameters:
  source_connection: balldontlie
  source_table: 'teams'
  destination: snowflake
  incremental_strategy: merge

$ bruin run assets/raw/balldontlie.asset.yml

  1. extract · balldontlie teamsincremental
  2. load · snowflake raw.teamsmerged
  3. checks · not_null, unique

Loaded and checked. Downstream models can run.

How it connects

Connected in three steps.

BallDontLie provides FIFA World Cup API endpoints for teams, stadiums, matches, players, rosters, lineups, events, and match analytics. For endpoint parameters, plan tiers, and implementation notes across the selected soccer providers, see the BallDontLie FIFA source research.

  1. 01

    Add a balldontlie connection with its credentials.

  2. 02

    Pick the tables to load and how: replace, append or merge.

  3. 03

    Bruin runs it on your schedule and checks every load.

Connection parameters

apikey
BallDontLie API key. Required.
season
World Cup season. Supported values are 2018, 2022, and 2026. Defaults to 2026.
baseurl
Overrides the API base URL. Defaults to https://api.balldontlie.io.

Tables

15 tables, ready to load.

  • teams
  • stadiums
  • groupstandings
  • matches
  • players
  • rosters
  • matchlineups
  • matchevents
  • playermatchstats
  • teammatchstats
  • matchshots
  • matchmomentum
  • matchbestplayers
  • matchavgpositions
  • matchteamform

The platform

Part of the Bruin platform.

Data in, ready for everything downstream: the models, the checks, the lineage and the AI layer.

01 · Move

Data Ingestion

02 · Model & govern

SQL & Python
Data Quality
Data Governance

03 · Use

AI Data Analyst
AI Dashboards
Data Apps
Self-Healing Pipelines
Bruin Cloudorchestration · governance · observability

Frequently asked

Questions about balldontlie.

Does Bruin have a built-in balldontlie integration?

Yes. Built-in ingestr source.

Which balldontlie tables can Bruin load?

teams, stadiums, groupstandings, matches, players, rosters, matchlineups, matchevents, playermatchstats, teammatchstats, matchshots, matchmomentum, and 3 more.

Where can balldontlie data go?

Snowflake, BigQuery, Databricks, Redshift, ClickHouse, Postgres, DuckDB, MotherDuck, Microsoft Fabric and more, plus files on S3 and GCS.

How fresh is the data?

As fresh as your schedule. Incremental loads append, merge or replace a time window, every few minutes if you like.

Do we need Bruin Cloud?

No. The Bruin CLI and ingestr run locally, in CI or in your own orchestrator. Bruin Cloud adds scheduling, lineage, alerts and the AI data analyst on top.

Ready to connect balldontlie?

$100 in credits and 50 AI tasks. No credit card.

A demo walks through your own data.

Sign up to our newsletter

Practical updates on open-source data pipelines, AI analysts, governance, and what we are shipping at Bruin.

The signup form is hosted by Brevo. Allow marketing cookies to load it.