Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/margostino/anfield-api
GraphQL API to retrieve the Fantasy Premier League data
https://github.com/margostino/anfield-api
fantasy-premier-league golang premier-league vercel
Last synced: about 2 months ago
JSON representation
GraphQL API to retrieve the Fantasy Premier League data
- Host: GitHub
- URL: https://github.com/margostino/anfield-api
- Owner: margostino
- Created: 2024-01-20T22:31:14.000Z (12 months ago)
- Default Branch: master
- Last Pushed: 2024-02-02T16:40:41.000Z (11 months ago)
- Last Synced: 2024-06-21T18:55:18.872Z (7 months ago)
- Topics: fantasy-premier-league, golang, premier-league, vercel
- Language: Go
- Homepage: https://anfield-api-margostino.vercel.app/api/playground
- Size: 7.11 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Anfield API
This project introduces a GraphQL API, developed using Golang and hosted on Vercel, designed to streamline access to **public** information from the Fantasy Premier League. Its primary objective is to offer a simplified, unified, and user-friendly method for retrieving Fantasy Premier League data, eliminating the need to interact with multiple separate endpoints.
## Endpoints
- Query: https://anfield-api-margostino.vercel.app/api/query
- Playground: https://anfield-api-margostino.vercel.app/api/playground
## Authentication
The API is using the Fantasy Premier League public API, but authentication is required simply to control some minimal rate limits. The API is using a simple token-based authentication, where the token is passed in the `Authorization` header. Yes, for free!
```http
Authorization : Bearer
```
You can request a token by sending an email to me or creating an issue in this repository.
## Schema
You can find the GraphQL Schema [here](https://raw.githubusercontent.com/margostino/anfield-api/master/graph/schema.graphqls)
The API provides the following:
- Teams information (e.g. name, short name, code, strength attack, etc.)
- Players information (e.g. name, teams, points, cost, game stats, etc.)
- Events information (e.g. kick-off datetime, stats, etc.)
- Head to Head information with historical games between 2 teams (e.g. team names, team scores, etc.)
## Example of queries
### Get all players
```graphql
{
players {
webName
team
news
position
chanceOfPlayingNextRound
expectedGoals
form
nowCost
pointsPerGame
selectedByPercent
selectedRank
selectedRankType
totalPoints
minutes
goalsScored
assists
cleanSheets
goalsConceded
ownGoals
influence
ownGoals
ictIndex
threat
creativity
bonus
redCards
yellowCards
}
}
```
### Get player by name
```graphql
{
player(webName: "Salah") {
webName
team
news
position
chanceOfPlayingNextRound
}
}
```
### Get all players of a team
```graphql
{
players(teamShortName: "LIV") {
webName
team
news
position
chanceOfPlayingNextRound
expectedGoals
form
nowCost
pointsPerGame
selectedByPercent
selectedRank
selectedRankType
totalPoints
minutes
goalsScored
assists
cleanSheets
goalsConceded
ownGoals
influence
ownGoals
ictIndex
threat
creativity
bonus
redCards
yellowCards
}
}
```
# Support
For support, issues, or contributions, please visit our GitHub repository.
# License
Anfield API is licensed under the [MIT license](https://github.com/margostino/anfield-api/blob/master/LICENSE)