pff.com APIpff.com ↗
Access PFF.com football data via API: fantasy draft rankings, weekly PPR rankings, NCAA schedules, game scoring plays, and current NFL season info.
curl -X GET 'https://api.parse.bot/scraper/c1e87591-5624-4c85-9107-5ce188f3ebcb/get_fantasy_rankings' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve fantasy football draft rankings. Returns player details including team info, ADP data, tiers, and ranker projections. Pagination param is accepted but may not affect results.
| Param | Type | Description |
|---|---|---|
| page | integer | Pagination page number. |
| league_type | string | League format. Accepted value: 'standard'. |
| scoring_type | string | Scoring format. 'REDRAFT_PPR' populates ADP data; other values accepted but may null out ADP fields. |
{
"type": "object",
"fields": {
"rankings": "array of player objects with id, firstName, lastName, position, teamAbbreviation, rank, adp, tier, projection, and expertAnalysis"
},
"sample": {
"data": {
"rankings": [
{
"id": 122474,
"adp": 2.5,
"rank": {
"current": 1,
"position": 1,
"rankerName": "Nathan"
},
"tier": 1,
"lastName": "Gibbs",
"playerId": 122474,
"position": "RB",
"firstName": "Jahmyr",
"projection": {
"points": {
"low": null,
"mid": null,
"high": null
},
"position": {
"low": null,
"mid": null,
"high": null
}
},
"teamAbbreviation": "DET"
}
]
},
"status": "success"
}
}About the pff.com API
This API exposes 5 endpoints covering PFF.com football data, from fantasy draft and weekly rankings to NCAA college football schedules and in-game scoring plays. The get_fantasy_rankings endpoint returns per-player fields including ADP, tier, rank, and expert projections, while get_ncaa_matchup delivers quarter-by-quarter scoring plays with time remaining and possession data. Both redraft and weekly formats are supported across NFL and NCAA contexts.
Fantasy Football Rankings
The get_fantasy_rankings endpoint returns draft-focused rankings for standard and PPR formats. Each player object includes firstName, lastName, position, teamAbbreviation, rank, adp, tier, projection, and expertAnalysis. The scoring_type parameter controls ADP population — using REDRAFT_PPR fills ADP fields, while other values may null them out. A page parameter is accepted but may not affect result pagination in practice.
The get_fantasy_weekly_rankings endpoint covers in-season weekly rankings, filterable by position (QB, RB, WR, TE, K, DST) and scoring_type (ppr). Each result includes a matchup object and a rankers array alongside standard projection and team fields, making it suited for weekly lineup decisions.
NCAA College Football Schedule and Game Data
The get_ncaa_schedule endpoint accepts a season year (e.g., 2023, 2024) and returns an array of weeks, each containing a games array with slugs, team franchise info, scores, status, and betting lines. Game slugs from this endpoint are the required input for get_ncaa_matchup.
get_ncaa_matchup requires a game_slug and the matching season and week values sourced from get_ncaa_schedule. It returns a score object with home_score, away_score, quarter_description, stadium_name, and game state, plus a play_by_play array of scoring plays with description, time_remaining, and possession_side. The parameters are tightly coupled — mismatched slug/season/week combinations will not return valid data.
NFL Season Context
The get_nfl_current_week endpoint takes no parameters and returns the current NFL season year, weekType (e.g., REG, POST), and a human-readable description such as Super Bowl. This is useful for anchoring other requests to the live calendar without hardcoding season values.
- Build a fantasy draft board using player
rank,tier,adp, andprojectionfields fromget_fantasy_rankings - Automate weekly lineup suggestions by filtering
get_fantasy_weekly_rankingsby position and PPR scoring - Display live NCAA game scores and stadium info by chaining
get_ncaa_schedulewithget_ncaa_matchup - Analyze scoring play sequences for college games using
play_by_playquarter and time-remaining fields - Surface betting lines for NCAA matchups using the
betting linesdata inget_ncaa_schedulegame objects - Anchor NFL fantasy data requests to the correct season by querying
get_nfl_current_weekat runtime - Track which NFL period is active (regular season vs. playoffs) using the
weekTypefield
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does PFF have an official public developer API?+
What does `get_ncaa_matchup` actually return — just the final score or more detail?+
score object includes home_score, away_score, quarter_description, stadium_name, and game state fields. The play_by_play array contains each scoring play with a description, time_remaining, quarter_description, possession_side, and structured scoring_play details.Does the `get_fantasy_rankings` endpoint support dynasty or keeper league formats?+
league_type parameter accepts standard and the scoring_type parameter accepts REDRAFT_PPR (which populates ADP fields) along with other redraft formats. Dynasty or keeper-specific rankings are not currently exposed. You can fork the API on Parse and revise it to add an endpoint targeting those league formats.Is there a quirk with the `page` parameter in the rankings endpoints?+
page parameter is accepted by get_fantasy_rankings but may not affect the returned results — all available rankings may be returned regardless of the value passed. Treat pagination as advisory rather than guaranteed for this endpoint.Does the API cover NFL play-by-play data, not just NCAA?+
get_ncaa_matchup. The NFL endpoints cover fantasy rankings and the current week/season context. You can fork the API on Parse and revise it to add an NFL play-by-play endpoint.