https://github.com/andrelmlins/freesoccer

:soccer: Free API with results from national soccer competitions
https://github.com/andrelmlins/freesoccer

api competition free hacktoberfest hacktoberfest2021 scraping soccer

Last synced: about 4 hours ago
JSON representation

:soccer: Free API with results from national soccer competitions

• Host: GitHub
• URL: https://github.com/andrelmlins/freesoccer
• Owner: andrelmlins
• License: mit
• Created: 2018-11-19T12:00:04.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-05-26T03:37:35.000Z (6 months ago)
• Last Synced: 2024-06-11T18:05:58.573Z (5 months ago)
• Topics: api, competition, free, hacktoberfest, hacktoberfest2021, scraping, soccer
• Language: TypeScript
• Homepage: https://www.apifreesoccer.com/
• Size: 4.56 MB
• Stars: 36
• Watchers: 3
• Forks: 9
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        


![FreeSoccer](https://raw.githubusercontent.com/andrelmlins/freesoccer/master/public/logo.png)

[Free API](https://www.apifreesoccer.com/) with results from national football competitions

[![Docker Image CI](https://github.com/andrelmlins/freesoccer/actions/workflows/docker-image.yml/badge.svg)](https://github.com/andrelmlins/freesoccer/actions/workflows/docker-image.yml)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/andrelmlins/freesoccer/blob/master/LICENSE)

[![Docker Pulls](https://img.shields.io/docker/pulls/andrelmlins1/freesoccer)](https://hub.docker.com/repository/docker/andrelmlins1/freesoccer)

[![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/andrelmlins1/freesoccer)](https://hub.docker.com/repository/docker/andrelmlins1/freesoccer)

[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/andrelmlins/freesoccer.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/andrelmlins/freesoccer/context:javascript)



## Features

- 🕒 Scraping with CronJob

- 👨🏾‍💻 Exec scraping in Line Command

- 🐋 Docker Image with environment variables in Dockerhub

- 💻 Scraping in ServerSide and ClientSide

## Build Setup

```

# install dependencies

yarn install

# run the API

yarn start

# run scraping

yarn scraping [-c or --competition ] [-l or --last-year] [-t or --table]

```

## Federations

- CBF

- RFEF

- FFF

- FIGC

- DFB

- FPF

- FA

## Competitions

| Name                      | Country  | Sex | Year                  | Results | Table | Statistics | Flags |

| ------------------------- | -------- | --- | --------------------- | ------- | ----- | ---------- | ----- |

| Brasileirão Série A       | Brazil   | M   | 2012 - 2018           | ✔️      | ✔️    | ❌         | ✔️    |

| Brasileirão Série B       | Brazil   | M   | 2012 - 2018           | ✔️      | ✔️    | ❌         | ✔️    |

| Copa do Brasil            | Brazil   | M   | 2012 - 2018           | ✔️      | ➖    | ❌         | ✔️    |

| Copa do Brasil Sub-20     | Brazil   | M   | 2012 - 2018           | ✔️      | ➖    | ❌         | ✔️    |

| Copa do Brasil Sub-17     | Brazil   | M   | 2013 - 2018           | ✔️      | ➖    | ❌         | ✔️    |

| Copa Verde                | Brazil   | M   | 2014 - 2018           | ✔️      | ➖    | ❌         | ✔️    |

| La Liga                   | Spain    | M   | 2013/2014 - 2018/2019 | ✔️      | ✔️    | ❌         | ❌    |

| La Liga Segunda División  | Spain    | M   | 2013/2014 - 2018/2019 | ✔️      | ✔️    | ❌         | ❌    |

| Primera División Femenina | Spain    | F   | 2013/2014 - 2018/2019 | ✔️      | ✔️    | ❌         | ❌    |

| Premier League            | England  | F   | 2000/2001 - 2018/2019 | ✔️      | ❌    | ❌         | ❌    |

| Ligue 1                   | France   | M   | 2000/2001 - 2018/2019 | ✔️      | ✔️    | ❌         | ✔️    |

| Ligue 2                   | France   | M   | 2000/2001 - 2018/2019 | ✔️      | ✔️    | ❌         | ✔️    |

| Coupe Ligue               | France   | M   | 2000/2001 - 2018/2019 | ✔️      | ➖    | ❌         | ✔️    |

| Serie A                   | Italy    | M   | 2004/2005 - 2018/2019 | ✔️      | ✔️    | ❌         | ✔️    |

| Bundesliga                | Germany  | M   | 2000/2001 - 2018/2019 | ✔️      | ✔️    | ❌         | ✔️    |

| 2 Bundesliga              | Germany  | M   | 2000/2001 - 2018/2019 | ✔️      | ✔️    | ❌         | ✔️    |

| 3 Liga                    | Germany  | M   | 2008/2009 - 2018/2019 | ✔️      | ✔️    | ❌         | ✔️    |

| Allianz Frauen-Bundesliga | Germany  | F   | 2000/2001 - 2018/2019 | ✔️      | ✔️    | ❌         | ✔️    |

| 2 Frauen-Bundesliga       | Germany  | F   | 2018/2019             | ✔️      | ✔️    | ❌         | ✔️    |

| Liga NOS                  | Portugal | M   | 2009/2010 - 2018/2019 | ✔️      | ✔️    | ❌         | ❌    |

| Ledman LigaPro            | Portugal | M   | 2009/2010 - 2018/2019 | ✔️      | ✔️    | ❌         | ❌    |

## Data Sources

- [CBF](http://cbf.com.br/)

- [RFEF](http://www.rfef.es/)

- [Ligue 1](https://www.ligue1.com/)

- [Serie A](http://www.legaseriea.it/)

- [DFB](https://www.dfb.de/)

- [Liga Portugal](http://ligaportugal.pt/)

- [Premier League](https://www.premierleague.com/)

## Docker

[![dockeri.co](https://dockeri.co/image/andrelmlins1/freesoccer)](https://hub.docker.com/r/andrelmlins1/freesoccer)

There's an official docker image available on [Dockerhub](https://hub.docker.com/r/andrelmlins1/freesoccer):

```

$ docker pull andrelmlins1/freesoccer

$ docker run -d -p 80:8080 --name andrelmlins1/freesoccer

```

## Used libraries

- Typescript

- Pupeteer

- Axios

- Cheerio

- Express

- Mongoose

- Cron

## Contribution guidelines

If you want to contribute to **FreeSoccer**, be sure to review the

[contribution guidelines](CONTRIBUTING.md). This project adheres to

[code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to

uphold this code.

## License

FreeSoccer is open source software [licensed as MIT](https://github.com/andrelmlins/freesoccer/blob/master/LICENSE).