Data timing and rights
The questions people ask before they build on BirdieAPI: what the timestamps mean, how fresh each dataset is, and what the terms let you do with the data.
Timing
Measured on our own data. The data changelog shows when each dataset last refreshed.
- When do leaderboards and rounds update?
- Once a day at 10:00 UTC, so a finished round appears the next morning and an in-progress tournament updates once a day. A tournament is reread daily for 10 days after it ends to pick up corrections.
- What do the winner odds mean?
- Prices for the four men's majors only. For an upcoming major they're captured daily at 12:00 UTC, and every 6 hours in the week before. Past majors have weekly snapshots. The latest price is the last capture before the first round's date, and nothing is captured once play starts.
- Are ratings as-of?
- vs_field is the field's average on that course and round minus the player's score. The rating series uses only rounds before each date. adj_vs_field can be restated when the model is refitted.
- Do you keep revision history?
- No. We keep the current version of each record. When a source corrects a score, stat or play, the record is overwritten, and we don't keep the earlier version, a change log per record, or a revision id. The data changelog shows when each dataset last refreshed.
- Is there a free way to tell whether a response changed?
- Not per record. Calls are charged as normal, an empty answer is refunded, and the same call repeated within two minutes is charged once.
What you can do with the data
A plain summary of the terms, which control if the two ever differ.
- Can I store the data and build on it?
- Yes. While your account is open you can store what you pull for as long as you like, derive values from it, and use it for research, backtesting and training your own models. The same terms apply on the free plan and every paid plan.
- Can I use it in a commercial product?
- Yes. You can build commercial apps, websites and tools on BirdieAPI data, show your users statistics, forecasts and other values you derive from it, and show individual data points, including individual odds, in your own app or dashboard. You can sell what you generate yourself, such as probabilities or model outputs.
- What isn't allowed?
- Passing the data on as a dataset, feed, file or API of its own, or building a service that competes with BirdieAPI using it. Redistributing odds, lines or prices as a raw or bulk feed or export. Presenting the data as official league data, or suggesting a league, team or player endorses you.
- What happens after I cancel?
- Data you stored while your account was open can still be used for your own internal purposes, such as research and backtesting. It doesn't cover a product that keeps serving users on the data, so keep an account open for as long as a product runs on it.
- Do you grant league rights?
- No. BirdieAPI is an independent data provider, not an official league partner, so league rights, marks and the league's own reports aren't ours to grant. If your use needs the league's permission, that's between you and the league.
- Do I need to credit you or anyone else?
- No attribution is required.
- Where does the data come from?
- BirdieAPI combines public sources and archives with its own models, and we don't publish a source list per dataset. Values we compute ourselves, such as ratings, expected goals or points and win probability, say so in each endpoint's docs.
Something not covered? Email support@birdieapi.com.