Docker Hub Tags Scraper

Lists the tags of a Docker Hub repository with their last push date, compressed size, first-image architecture and OS, and digest, together with the star and pull counts of the repository. Useful for tracking image releases, auditing base images and monitoring repository popularity.

Features

• Works with official images (library/nginx) and user or organisation repositories (bitnami/postgresql)
• Follows Docker Hub pagination until maxItems tags are collected
• Every tag item carries the repository star count, pull count and description
• Architecture and OS taken from the first image of each tag
• maxItems caps how many tags are returned (1 to 100)
• Uses the public Docker Hub API with retries, no browser and no proxy

Input

Field	Type	Required / default	Description
repository	string	required (prefill library/nginx)	Docker Hub repository in namespace/name form
maxItems	integer	default 25, min 1, max 100	Maximum number of tags to return

If repository is empty the run pushes a warning item and exits.

Example input:

{
  "repository": "library/nginx",
  "maxItems": 25
}

Output

One dataset item per tag:

• repository - the repository requested
• starCount - repository stars, or null
• pullCount - repository pulls, or null
• repoDescription - short repository description, or null
• tagName - tag name
• lastUpdated - ISO timestamp of the last push for the tag, or null
• fullSize - compressed size in bytes, or null
• architecture - architecture of the first image in the tag, or null
• os - operating system of the first image in the tag, or null
• digest - tag digest, or null
• scrapedAt - ISO timestamp of the extraction

If the repository has no tags the run pushes a warning item. If the repository cannot be fetched (for example it does not exist) the run pushes repository and error.

{
  "repository": "library/nginx",
  "starCount": 20000,
  "pullCount": 10000000000,
  "repoDescription": "Official build of Nginx.",
  "tagName": "1.27-alpine",
  "lastUpdated": "2026-08-30T10:15:00.000Z",
  "fullSize": 20500000,
  "architecture": "amd64",
  "os": "linux",
  "digest": "sha256:0123456789abcdef...",
  "scrapedAt": "2026-09-10T12:00:00.000Z"
}

Pricing

Pay per event. The Actor charges the item-scraped event ("Item scraped") at $0.0008 per tag item returned. Warning and error items are not charged. There is no separate Actor start fee.

Free plan

The Actor checks whether the run belongs to a paying Apify account. On the free plan maxItems is capped at 10 per run, so free users receive up to 10 real tags to inspect the output format. Larger runs require a paid Apify plan.

Usage

From the Apify console, type the repository into repository, set maxItems and click Start.

Via API:

curl -X POST "https://api.apify.com/v2/acts/gio21~dockerhub-tags-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repository": "library/nginx", "maxItems": 25}'

Limitations

• One repository per run
• Tags are returned in the default Docker Hub order (most recently pushed first), there is no name filter or sorting option
• Only the first image of a multi-arch tag is described; other architectures are not listed
• Private repositories are not supported (no authentication)
• Docker Hub applies rate limits to anonymous API requests; heavy use may hit them

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Docker or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.