# PlayerSignal Public API

PlayerSignal exposes read-only public JSON endpoints for agents and crawlers. Private admin, claim and profile-owner APIs are not part of this catalog.

## Discovery

- API catalog: https://playersignal.app/.well-known/api-catalog
- OpenAPI description: https://playersignal.app/api/openapi.json
- Public status: https://playersignal.app/status.json including configured youth dataset and senior-pathway DBU source metadata, `publishedSummary` merged from live runner status, `lastPublishedDatasetUpdate`, `runnerCadence` and `emptyUpcomingSourcesPolicy`.
- Agent card: https://playersignal.app/.well-known/agent-card.json
- MCP server card: https://playersignal.app/.well-known/mcp/server-card.json

## Public endpoints

- `GET /api/status` - data health and scan status.
- `GET /api/dataset-index` - public dataset metadata.
- `GET /api/datasets?season=2025%2F26&league=Liga&ages=U17%2CU19` - ranking rows.
- `GET /api/player?slug=alexander-holmquist-larsen` - public player profile payload.
- `GET /api/transfers?days=400&ages=U17%2CU19` - rolling 400-day transfer-signal data; do not add a season filter.
- `GET /exports/player-rankings.csv` - spreadsheet-ready player rows with source labels.
- `GET /exports/club-summary.csv` - spreadsheet-ready club totals with direct club links and source labels.
- `GET /signals.json` - Player Trajectory Score and Club Talent Radar data.
- `GET /pathways.json` - Team Pathway Maps for U17, U19 and senior movement signals.
- `GET /opportunities.json` - Opportunity Index shortlist for high-role players with lower current public visibility.
- `GET /scout-briefs.json` - Scout Brief Generator scout-ready player briefs.
- `GET /weekly-changes.json` - Weekly Signal Changes player movement alerts.
- `GET /insight.json` - PlayerSignal Insight bundle metadata for Signals, Opportunity Index, Weekly Signal Changes, Scout Brief Generator and Team Pathway Maps.
- `GET /sources.json` - configured youth dataset and senior-pathway DBU source registry with published youth snapshot metadata.

See https://playersignal.app/data for a human-readable public data catalog with source labels and intended use.
See https://playersignal.app/sources for published and configured DBU source URLs, including upcoming youth season sources before snapshots exist and senior-pathway sources for post-U19 tracking.

## Auth

Public endpoints do not require authentication. Profile-owner and admin endpoints use the shared sign-in system documented in https://playersignal.app/auth.md.