https://github.com/issif/docker-pulls-scraper
Scrape DockerHub stats to track the count of pulls of your images
https://github.com/issif/docker-pulls-scraper
Last synced: 17 days ago
JSON representation
Scrape DockerHub stats to track the count of pulls of your images
- Host: GitHub
- URL: https://github.com/issif/docker-pulls-scraper
- Owner: Issif
- Created: 2023-10-17T15:37:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-06-25T08:44:22.000Z (22 days ago)
- Last Synced: 2026-06-25T10:20:44.086Z (22 days ago)
- Language: HTML
- Homepage: https://issif.github.io/docker-pulls-scraper
- Size: 6.86 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker pulls scraper
DockerHub provides an API endpoint to track the number of pulls of the images it hosts but no history. This small program allows to get that count and updates a .csv file to keep a record.
It generates one `.csv` file per image, with the columns: `Date, Count`. Up to you to run the script every X times to add a new line in the files.
## Build
```shell
go build
```
## Usage
```shell
Usage of docker-pulls-scraper:
-d string
Destination folder for .csv (default "./data")
-l string
File with the list of images to track
-r string
Destination folder for the .html (default "./render")
```
## List of images
The list of images must be in file, with one image per line, like this:
```
owner/image-1
owner/image-2
owner/image-3
```
### Results
Log:
```
❯ go run . -l list.txt
2023/10/17 18:34:58 Folder './data' already exists
2023/10/17 18:34:58 Scrape pull count for the image 'falcosecurity/falco'
2023/10/17 18:34:59 Writing of the .csv for the image 'falcosecurity/falco' in './data/falcosecurity_falco.csv'
2023/10/17 18:34:59 Scrape pull count for the image 'falcosecurity/falcosidekick'
2023/10/17 18:34:59 Writing of the .csv for the image 'falcosecurity/falcosidekick' in './data/falcosecurity_falcosidekick.csv'
2023/10/17 18:34:59 Scrape pull count for the image 'falcosecurity/falcosidekick-ui'
2023/10/17 18:34:59 Writing of the .csv for the image 'falcosecurity/falcosidekick-ui' in './data/falcosecurity_falcosidekick-ui.csv'
2023/10/17 18:34:59 Scrape pull count for the image 'falcosecurity/driverkit'
2023/10/17 18:34:59 Writing of the .csv for the image 'falcosecurity/driverkit' in './data/falcosecurity_driverkit.csv'
2023/10/17 18:34:59 Scrape pull count for the image 'falcosecurity/falcoctl'
2023/10/17 18:34:59 Writing of the .csv for the image 'falcosecurity/falcoctl' in './data/falcosecurity_falcoctl.csv'
```
Example of a `.csv` file:
```csv
Date,Count
2023/03/15,43254957
2023/03/16,43268631
2023/03/17,43283486
2023/03/18,43293650
```
## Author
Thomas Labarussias (https://github.com/Issif)