Docker Hub Scraper — Images, Pulls, Stars & Tags

Search Docker Hub or look up exact repositories and get back clean, structured JSON: short and full description, star count, pull count, official and automated flags, last-updated date, categories, storage size and (optionally) tags with sizes and push dates. It pulls from the public Docker Hub API — no login, no API key. Built for DevOps engineers, security teams and OSS researchers who need reliable image metadata at scale.

Features

• 🔎 Free-text search — run any Docker Hub query (postgres, machine learning) and collect matching repositories in bulk.
• 🎯 Exact lookups — pass official images like nginx or namespaced repos like bitnami/postgresql, combined with search results.
• 📊 Popularity metrics — capture starCount and pullCount for every repository.
• 🏷️ Official & automated flags — isOfficial and isAutomated to filter trusted images.
• 🗂️ Full details — optional fullDescription, categories, storageSize, lastUpdated and dateRegistered.
• 🔖 Tags on demand — optional tags array with name, fullSize, lastUpdated and digest, capped by maxTags.
• 🔗 Ready to use — every record includes dockerHubUrl and a copy-paste pullCommand.

What you get

Each repository becomes one clean JSON record:

{
  "repoName": "library/nginx",
  "name": "nginx",
  "namespace": "library",
  "isOfficial": true,
  "isAutomated": false,
  "starCount": 19876,
  "pullCount": 10500000000,
  "shortDescription": "Official build of Nginx.",
  "fullDescription": "# What is Nginx?\n\nNginx is an open source reverse proxy server...",
  "categories": ["Web Servers"],
  "storageSize": 67108864,
  "lastUpdated": "2024-05-29T18:44:12.000000Z",
  "dateRegistered": "2014-06-05T21:31:04.000000Z",
  "dockerHubUrl": "https://hub.docker.com/_/nginx",
  "pullCommand": "docker pull library/nginx",
  "tags": [
    { "name": "latest", "fullSize": 72401234, "lastUpdated": "2024-05-29T18:44:12.000000Z", "digest": "sha256:abc123..." }
  ]
}

Input

{
  "queries": ["postgres"],
  "repositories": ["nginx", "bitnami/postgresql"],
  "maxPerQuery": 50,
  "includeDetails": true,
  "includeTags": false,
  "maxTags": 20
}

Field	Description
queries	Free-text Docker Hub searches (repository name and description). Each is scraped separately.
repositories	Exact repos by name, e.g. nginx (official) or bitnami/postgresql, combined with search results.
maxPerQuery	Maximum repositories to collect per search query (1–1000).
includeDetails	Fetch each repo's detail (full description, last updated, categories, storage size).
includeTags	Fetch each repository's tags (name, size, last pushed).
maxTags	Maximum tags to fetch per repository when tags are included (1–100).

Use cases

• Compare pull and star counts across competing images before choosing a base.
• Inventory the tags and sizes available for a set of images in your stack.
• Filter for official images to harden a supply-chain security review.
• Build a catalog of images for a topic (e.g. databases) for research or docs.

Pricing

Pay-per-event: you're billed a small amount per run and per item scraped — you only pay for what you get. See the Pricing tab for current rates.

FAQ

Do I need a Docker Hub account or API key? No. The actor reads from the public Docker Hub API, so no login or API key is required.

How many repositories can I scrape per run? Each free-text query can return up to 1000 repositories (maxPerQuery), and you can add exact repos — official images like nginx or namespaced repos like bitnami/postgresql — in the repositories field.

Is scraping Docker Hub allowed? This actor only reads publicly available repository metadata through Docker Hub's own public API; it does not pull image layers or access private repos. Review Docker's terms before large-scale or commercial reuse.

What's the output format? Structured JSON — one record per repository with fields such as starCount, pullCount, isOfficial, shortDescription, categories, storageSize, a ready-to-use pullCommand and optional tags. Export as JSON, CSV, Excel or via the API.

Can I get the tags for each image? Yes. Set includeTags to attach a tags array (name, fullSize, lastUpdated, digest) and use maxTags (1–100) to cap how many tags are fetched per repository.

Related Actors

Building a supply-chain or DevOps data set? Combine this with our other developer-data scrapers:

• GitHub Scraper — repositories and user profiles with stars, topics, licenses and leads.
• npm Package Scraper — search and look up npm packages with metadata, dependencies and downloads.
• PyPI Package Scraper — metadata, dependencies, licenses and downloads for Python packages.
• crates.io Scraper — Rust crate metadata, versions, licenses and download trends.

Notes

This actor uses the public Docker Hub API and reads only publicly available repository data. It is an independent tool and is not affiliated with, endorsed by, or sponsored by Docker, Inc.; "Docker" and "Docker Hub" are trademarks of Docker, Inc.