API Docs

Base URL: https://dev-soccerstat.vercel.app

All endpoints return JSON. No authentication required for read endpoints.

GET/api/search?q={name}

Search players by name. Returns up to 8 results with id, name, nationality, positions, and peak rating.

Example:/api/search?q=Maradona

GET/api/players/{id}

Coming soon

Fetch a full player profile including all seasons, attributes, peak rating, and career average.

Example:/api/players/abc123

GET/api/players?page={n}&sort={field}

Coming soon

List players with optional filters: position, nationality, league, year, status. Paginated at 30 per page.

Example:/api/players?position=ST&nationality=Brazil&sort=rating

GET/api/leaderboard

Coming soon

Top contributors ranked by XP. Returns user display names and XP totals.

Example:/api/leaderboard

Rate Limits

The public API is currently rate-limited to 60 requests per minute per IP. For higher limits or write access, contact us to discuss a partnership.