ParseForge
Docker Hub Scraper
parseforge/dockerhub-scraper
Developer toolsDEVELOPER_EXAMPLESOther
Scrapes Docker Hub repositories and container image metadata by search query or namespace. Returns pull counts, star counts, tags, descriptions, and official status.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 101
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 9 days ago
Overview
Docker Hub Scraper
Scrape Docker Hub repositories, container images, and metadata by keyword search or namespace, up to a million per run. Get pull counts, star counts, tags, descriptions, and official status. No API key or login. Export to CSV, JSON, Excel, or XML.
Docker Hub's official API requires authentication and rate limits you. This reads the public repository listings directly, filtered by search query or namespace, and returns each match in one fixed schema. It works for market research, competitive analysis, and registry monitoring.
| Who uses it | What they scrape Docker Hub for |
|---|---|
| Market researchers | Which container images are gaining traction in a category |
| Competitive analysts | How a vendor's images are positioned and adopted |
| Developer tool builders | Which base images and tags developers use |
| Security teams | Which public images an organization publishes and their update cadence |
| DevOps engineers | Which official images exist for a stack before writing a Dockerfile |
What it does
This Actor collects Docker Hub repositories by search query or namespace and returns each one as a flat row with pull counts, star counts, tags, descriptions, and official status.
- 🔍 Keyword search: find repositories matching a term like nginx, python, or postgres.
- 📁 Namespace listing: list every repository under a user or organization such as library, nginx, or bitnami.
- 📊 Metadata per repo: pull count, star count, tags, description, and official status.
- ⚡ High volume: collect up to 1,000,000 repositories in a single run.
- 📤 Flexible export: download as CSV, JSON, Excel, or XML.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Docker Hub data
📈 Track image popularity.
A market researcher runs the Actor weekly on a set of keywords and compares pull counts and star counts to spot rising container images.
🕵️ Audit an organization's public images.
A security engineer lists a company's namespace to see every public repository, its tags, and how recently it was updated.
🧩 Build a base image shortlist.
A DevOps engineer searches for a runtime like python, filters to official images, and picks the most maintained tag for a new Dockerfile.
📊 Monitor competitors.
A product analyst scrapes a rival's namespace each month and tracks new repositories and pull growth to infer roadmap.
Why choose this scraper
| What you get | |
|---|---|
| No API key | Reads public Docker Hub pages directly, no registration or token |
| Fixed schema | Every repository returns the same flat fields for easy joins |
| Bulk friendly | Collect up to a million repositories in one run |
| Two modes | Search by keyword or list an entire namespace |
How it compares
This Actor focuses on bulk repository collection by search or namespace, while the competitors below offer similar Docker Hub scraping with varying feature sets.
| Feature | ParseForge | Docker Hub Image Scraper | Docker Hub Scraper | Docker Hub Scraper - Search, Repos & Tags |
|---|---|---|---|---|
| Search by keyword | Yes | Yes | Yes | Yes |
| List repositories by namespace | Yes | Not listed | Not listed | Yes |
| Pull count | Yes | Yes | Not listed | Yes |
| Star count | Yes | Yes | Not listed | Yes |
| Tags | Yes | Yes | Not listed | Yes |
| Description | Yes | Yes | Not listed | Yes |
| Official status | Yes | Not listed | Not listed | Yes |
Configure the run
Drive the Actor with a search query or a namespace. If both are empty, it defaults to searching nginx. The maxItems field caps how many repositories are collected per run. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10,
"searchQuery": "nginx"
}
A larger pull:
{
"maxItems": 200,
"searchQuery": "nginx"
}
Pricing
Pay-per-result: $0.021 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Docker Hub Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Docker Hub through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/dockerhub-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check your search query or namespace. If both are empty, it defaults to nginx. Also ensure the namespace exists and is public.
Why did the run stop before reaching maxItems?
Docker Hub may paginate results, and the Actor stops when no more repositories are available for the given query or namespace.
Why are some fields empty?
Not every repository has a description, tags, or official status. Empty fields mean Docker Hub did not provide that data.
Can I scrape a specific repository's details?
Currently the Actor lists repositories by search or namespace. For a single repository, use a namespace that contains it or a precise search query.
Why did I get a timeout error?
Large runs may hit platform limits. Reduce maxItems or split the run into smaller chunks.
FAQ
| Question | Answer |
|---|---|
| Do I need a Docker Hub account or API key? | No. The Actor reads public Docker Hub pages directly, so no login, token, or registration is required. |
| What is the difference between search query and namespace? | Search query finds repositories matching a keyword across Docker Hub. Namespace lists every repository under a specific user or organization. If both are set, namespace takes priority. |
| What happens if I leave both search query and namespace empty? | The Actor defaults to searching for nginx, so you still get results. |
| How many repositories can I collect in one run? | You can set maxItems up to 1,000,000. The default is 10. |
| What fields are returned for each repository? | Each row includes the repository name, pull count, star count, tags, description, and official status, among other metadata. |
| Can I export the data? | Yes, you can export the dataset as CSV, JSON, Excel, or XML from the Apify platform. |
| Does this scrape private repositories? | No, only public repositories visible on Docker Hub are collected. |
| Is this an official Docker product? | No, this is an independent scraper built on Apify. It is not affiliated with Docker Inc. |
| Can I schedule this Actor to run automatically? | Yes, you can set up a schedule in Apify to run it hourly, daily, or weekly. |
| What is the difference between this and the Docker Hub API? | The official API requires authentication and has rate limits. This Actor reads public pages directly, so no key is needed and you can collect large volumes. |
Related actors
- pypi-scraper: Use this to scrape Python package metadata from PyPI instead of container images.
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Docker Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| maxItems | integer | How many repositories to collect per run. | 10 |
| searchQuery | string | Search Docker Hub for images (e.g. 'nginx', 'python', 'postgres'). Used when Namespace is not set. | nginx |
| namespace | string | List all repos for a Docker Hub user or organization (e.g. 'library', 'nginx', 'bitnami'). Takes priority over Search Query. | not set |
Pricing
from $19.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.019 to $0.021 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~dockerhub-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.