Getting Started

The PEARatings API is a REST API for the numbers behind this site: ratings, team stats, schedules and game projections, players, box scores, play-by-play, tournament outlooks and simulations. It covers college baseball (D1, D2, D3 and NAIA) and college softball (D1, D2 and D3). Football is not in the API.

Every request goes to one base URL and returns JSON:

https://api.pearatings.com/v1

Get a free key with just an email on the pricing page. The key is shown once, so copy it when you see it. Keep it out of your code by storing it in an environment variable:

export PEAR_API_KEY='your-key'

This asks for the current D1 baseball ratings. The key goes in the X-API-Key header of every request.

curl -H "X-API-Key: $PEAR_API_KEY" \
  https://api.pearatings.com/v1/baseball/d1/ratings

A successful call returns the date of the ratings, the number of teams and one object per team:

{
  "teams": [
    {
      "Team": "Auburn",
      "power_rating": 6.68,
      "PCR": 1,
      "pcr_score": null,
      "Conference": "SEC",
      "Season": 2027
    },
    ...
  ],
  "date": "January 01, 2027",
  "count": 309
}

Most paths follow one pattern, /v1/{sport}/{division}/{what}, where the sport is baseball or softball and the division is d1, d2, d3 or naia. Swap either one to get the same data for another division: /v1/softball/d2/ratings.

• Python quickstart: the official pearatings package returns every table as a pandas DataFrame.
• API Reference: every endpoint, its parameters and the tier it needs.
• Methodology: what each PEAR number measures and how to read it.

Before building further, read Authentication, Tiers and limits and Data availability.