← Back to Home

API Documentation

Access FFStatChecker's fantasy football data programmatically

🚀 Welcome to FFStatChecker API

Our API provides access to real-time fantasy football rankings, player analysis, and AI-powered recommendations. Perfect for developers building fantasy sports applications or conducting research.

🔗 Base URL

https://ffstatchecker.com/api

All API endpoints are relative to this base URL. For local development: http://localhost:3000/api

For production: https://ffstatschecker.com/api

📋 Available Endpoints

GET

/rankings

Retrieve current fantasy football player rankings with projections and team information.

Query Parameters:

Parameter	Type	Default	Description
page	integer	1	Page number for pagination
leagueType	string	standard	League type (standard, ppr, half-ppr)
scoringType	string	REDRAFT_PPR	Scoring system type

Example Request:

curl -X GET "https://ffstatchecker.com/api/rankings?page=1&leagueType=standard"

Example Response:

{
  "rankings": [
    {
      "playerId": "123456",
      "firstName": "Christian",
      "lastName": "McCaffrey", 
      "position": "RB",
      "teamName": "San Francisco 49ers",
      "teamAbbreviation": "SF",
      "rank": {
        "current": 1
      },
      "projection": {
        "points": {
          "mid": 280.5
        }
      }
    }
  ]
}
                        

GET

/homepage-content

Get AI-curated content for homepage including popular, trending, and breakout candidates.

Example Response:

{
  "popular": {
    "name": "Christian McCaffrey",
    "position": "RB",
    "team": "SF",
    "projectedPoints": 16.5,
    "rank": 1,
    "reason": "Elite fantasy producer with consistent dual-threat value"
  },
  "trending": [
    {
      "name": "Jahmyr Gibbs", 
      "position": "RB",
      "team": "DET",
      "projectedPoints": 18.4,
      "rank": 3,
      "reason": "Explosive rookie with increasing usage"
    }
  ],
  "breakout": [...]
}
                        

POST

/start-sit-analysis

Get AI-powered start/sit recommendations for specific player matchups.

Request Body:

Field	Type	Required	Description
player	object	Yes	Player object with name, position, team, projectedPoints
opponent	string	Yes	Opponent team abbreviation (e.g., "LAR")

Example Request:

curl -X POST "https://ffstatchecker.com/api/start-sit-analysis" \
  -H "Content-Type: application/json" \
  -d '{
    "player": {
      "name": "Christian McCaffrey",
      "position": "RB", 
      "team": "SF",
      "projectedPoints": 16.5
    },
    "opponent": "LAR"
  }'
                        

Example Response:

{
  "recommendation": "START",
  "analysis": "McCaffrey faces a favorable matchup against the Rams' middle-tier run defense...",
  "player": {...},
  "opponent": "LAR"
}
                        

GET

/players/search

Search for players by name and get their basic information.

Query Parameters:

Parameter	Type	Required	Description
query	string	Yes	Player name to search for

Example Request:

curl -X GET "https://ffstatchecker.com/api/players/search?query=Christian McCaffrey"
                        

🔐 Authentication

Good News! All endpoints are currently public and do not require authentication.

Our API is free to use for personal and educational purposes. For commercial use or higher rate limits, please contact us.

⚡ Rate Limiting

Rate Limits: To ensure fair usage, we implement the following limits:

100 requests per minute per IP address
1000 requests per hour per IP address

📊 Response Format

All API responses are returned in JSON format with appropriate HTTP status codes:

Status Code	Description
200	Success - Request completed successfully
400	Bad Request - Invalid parameters or request format
404	Not Found - Endpoint or resource not found
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - Server-side error occurred

🛠️ SDK and Libraries

Currently, we provide REST API access. SDKs for popular programming languages are planned for future releases:

JavaScript/Node.js: Coming soon
Python: Planned
PHP: Planned
Java: Under consideration

📞 Support

Need help with the API? We're here to assist:

Email: yusufabbasi153@gmail.com
Response Time: Typically within 24-48 hours
Documentation: This page is regularly updated

📢 Stay Updated

API updates and new endpoints will be announced on our website. We maintain backward compatibility and provide advance notice of any breaking changes.