🐳 Docker Hub Image Search and Lookup Scraper

🚀 Pull Docker Hub repositories with tags, stars, pull count, official flag, storage size, last update, content types, categories, and full README.

🕒 Last updated: 2026-05-08 · 📊 29+ fields per record · Docker Hub repositories · stars, pull count, tags, full description, categories, storage size, content types, official flag, source repo · search and lookup

The Docker Hub Image Search and Lookup Scraper pulls rich repository metadata from Docker Hub. Output includes repo name + owner, short + full description (full README markdown), star count, pull count, official + verified + automated flags, status, storage size, media types, content types, categories, collaborator count, hub user, source repo URL, dates registered + last modified, and the most-recent tags with sizes and last-updated timestamps.

Two modes in one Actor: free-text search across the entire Docker Hub catalog, and direct repository lookup by owner/name (or library/name for official images). Tag enrichment runs automatically and pulls the 30 most recent tags per repo by default.

🎯 Target Audience	💡 Primary Use Cases
DevOps engineers, container security teams, SBOM builders, container-discovery tools, Kubernetes operators, ML researchers	Container supply chain analysis, base-image curation, popular-image dashboards, image-discovery tools, ecosystem health monitoring

---

📋 What the Docker Hub Image Search and Lookup Scraper does

Five filtering workflows in a single run:

• 🔍 Search. Docker Hub full-text search.
• 🆔 Lookup. Pull specific repos by owner/name.
• 🏷️ Tags + sizes. 30 most recent tags with sizes and last-updated.
• 📜 Full README. Markdown body of the long description.
• ✅ Official + verified flags. Distinguish trusted publishers.

💡 Why it matters: clean, server-side filtering and fresh data on every run.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan up to 1,000,000.
mode	string	"search"	search or lookup.
query	string	""	Search term (search mode).
names	string	""	Newline-separated owner/name (lookup mode). Bare names assume `library/`.
fetchTags	boolean	true	When true, fetches 30 most-recent tags per repo.

Example: search popular language images.

{
    "maxItems": 50,
    "mode": "search",
    "query": "python",
    "fetchTags": true
}

Example: lookup official base images.

{
    "maxItems": 10,
    "mode": "lookup",
    "names": "library/nginx\nlibrary/redis\nlibrary/postgres\nlibrary/python"
}

---

📊 Output

Each record contains 29+ fields. Download as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
📛 repoName	string	"library/nginx"
👤 repoOwner	string	"library"
📜 shortDescription	string	"Official build of Nginx."
📜 fullDescription	string	"# What is Nginx?..."
⭐ stars	number	20500
📥 pullCount	number	8200000000
✅ isOfficial	boolean	true
✅ isVerified	boolean	false
📊 storageSize	number	158234567
🏷️ mediaTypes	array	["application/vnd.docker.distribution.manifest.v2+json"]
📁 contentTypes	array	["image"]
🏷️ categories	array	["Web Servers"]
👤 hubUser	string	""
🌐 sourceRepo	string	"https://github.com/nginxinc/docker-nginx"
📅 dateRegistered	string	"2014-06-09T20:29:59.000Z"
📅 lastUpdated	string	"2026-04-30T18:21:31.000Z"
🏷️ tags	array	["latest","mainline","stable",...]
📊 tagCount	number	987
🌐 dockerHubUrl	string	"https://hub.docker.com/r/library/nginx"

📦 Sample records

---

✨ Why choose this Actor

	Capability
⭐	Real popularity signals. Stars + pull count side-by-side.
🏷️	Tag enrichment. 30 most recent tags with sizes per repo, ready for image-pin tooling.
✅	Trust flags. Official, verified, automated flags expose publisher trust.
📜	Full README. Long description (markdown body) for image-discovery UIs.
🆓	No auth. Public Docker Hub API.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ This Actor	$5 free credit	Docker Hub	Live per run	2 modes	⚡ 2 min
Docker Hub API	Free	Same	Live	DIY	🐢 Code
Docker Scout (paid)	$$	Larger	Live	Yes	🐢 Account
Manual scraping	Free	All	Live	DIY	🐢 Days

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Find the Docker Hub Image Search and Lookup Scraper on the Apify Store.
3. 🎯 Set input. Pick filters and maxItems.
4. 🚀 Run it. Click Start.
5. 📥 Download. Grab results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

🐳 DevOps + Platform Base-image curation Image-pin tooling Trusted-publisher inventories Pull-trend dashboards	🔐 Container Security SBOM for container deps Vulnerability triage Image-source validation Trust-tier analysis
📊 Ecosystem Analytics Most-pulled leaderboards Category distribution Stars vs pulls correlation Tag-evolution studies	📚 Discovery + Education Image-search engines Best-practice base-image guides Container learning Community curation

---

🔌 Automating Docker Hub Image Search and Lookup Scraper

Control the scraper programmatically:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval.

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows.

🎓 Research and academia Container-ecosystem studies Reproducible image snapshots Pull-trend analysis Image-similarity research	🎨 Personal and creative Personal Docker dashboards Curated image lists Side projects with registry data Image-blog backbones
🤝 Non-profit and civic Free SBOM tools Educational container maps Civic tech inventories OSS security awareness	🧪 Experimentation Train image recommenders Prototype security scanners Build pull-graph systems Test trust-tier classification

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick search or lookup mode. Search runs Docker Hub's full-text search; lookup pulls specific repos by owner/name.

📊 How many fields per record?

29 base, plus tag arrays when fetchTags is enabled.

🏷️ Are tags fetched?

Yes by default. The 30 most recent tags per repo, with sizes and last-updated timestamps.

✅ What's the difference between official and verified?

Official images are maintained by Docker (e.g. library/nginx). Verified are external publishers vetted by Docker.

📜 Does the full README come back?

Yes. The long description (markdown body) is included as fullDescription.

🆓 Do I need an API key?

No. The Docker Hub API is open.

🔁 Can I schedule runs?

Yes. Schedule daily to track new tags and pull-count changes.

⚖️ Is this data free to use?

Yes. Docker Hub metadata is publicly available.

📦 Are private repos accessible?

No. This Actor only scrapes public repositories.

💳 Do I need a paid Apify plan?

No. The free plan covers preview runs (10 records).

---

🔌 Integrate with any app

Docker Hub Image Search and Lookup Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications
• Airbyte - Pipe data into your warehouse
• GitHub - Trigger runs from commits
• Google Drive - Export datasets to Sheets

---

🔗 Recommended Actors

• 📦 npm Package Registry - Pull npm packages with version, downloads, dependencies, integrity
• 🐍 PyPI Python Package - Pull PyPI packages with version, license, classifiers, vulnerabilities
• 🦀 crates.io Rust Package - Pull Rust crates with edition, downloads, features, dependencies
• 💎 RubyGems Ruby Package - Pull RubyGems with version, downloads, dependencies, ruby version
• 📊 Stack Exchange Questions - Search 170+ Stack Exchange Q&A sites

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Docker Inc., the Docker Hub maintainers, or any individual image publisher. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.