# NPM Package Scraper โ€” Downloads, Maintainers, Deps & SBOM (`logiover/npm-package-intelligence-scraper`) Actor Export every NPM package by keyword, maintainer, scope or name. Get version, license, repo URL, maintainers, daily/weekly/monthly downloads, dependents, deprecation, full deps, version history. Official NPM registry + stats API. For devtool intel, SBOM and OSS outreach. - **URL**: https://apify.com/logiover/npm-package-intelligence-scraper.md - **Developed by:** [Logiover](https://apify.com/logiover) (community) - **Categories:** Automation, Developer tools, Business - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## NPM Package Scraper โ€” Search, Downloads, Maintainers, Dependents, Versions & SBOM Data Discover and export **every NPM package** matching a keyword, maintainer, scope or direct name. For each package: name, version, description, keywords, license, repository URL, homepage, npm URL, **full maintainers list**, **weekly + monthly + yearly download counts**, **dependents count**, **deprecation status**, runtime + dev + peer dependencies, file engines, exports map, and **full version history** with publish dates. Built on the official **open NPM Registry API + npmjs downloads stats API** โ€” no token, no proxy, no scraping. Perfect for **developer-tool competitive intelligence**, **dependency security & SBOM workflows**, **open-source maintainer outreach**, **sponsorship targeting**, **package marketplace seeding**, and any **2026 JavaScript / Node.js ecosystem analytics**. --- ### ๐Ÿš€ What does this NPM scraper do? Two complementary input modes โ€” combine them or use one alone: | Mode | When to use | |------|-------------| | **Search Terms** | Discover packages matching a keyword, scope, maintainer or keyword tag โ€” paginated up to thousands of results per query | | **Package Names** | You already know which packages โ€” pass exact names (including scoped `@org/pkg`) | For each package, the actor combines **three sources** in one record: 1. **Search snippet** โ€” search score, dependents count, basic downloads 2. **Registry full doc** (`registry.npmjs.org/{pkg}`) โ€” full metadata, all versions, dist info, dependencies, maintainers 3. **Downloads stats** (`api.npmjs.org/downloads/*`) โ€” last-day / week / month / year point counts + optional daily history series --- ### ๐Ÿ’ก Use cases - **Devtool competitive intel** โ€” find every JS package mentioning `react` + `chart` and rank by weekly downloads - **OSS sponsorship outreach** โ€” pull every popular package's maintainers + GitHub repository URL โ†’ CRM - **Dependency security / SBOM** โ€” feed package metadata + dependency tree into a vulnerability monitor - **Package marketplace seeding** โ€” discover every Apache-2.0 / MIT package in a niche above 10k downloads - **Maintainer talent intel** โ€” find every maintainer of `@apify/*` packages for recruiting / partnership - **Trend monitoring** โ€” track weekly download deltas with `fetchDownloadsHistory` to surface fast-growing packages - **Migration analysis** โ€” pull every package using a deprecated dep and prioritize outreach - **AI training data** โ€” every package's README + description is high-quality NL data about JS APIs - **OSS health dashboards** โ€” combine deprecation status + last-publish-date + maintainer count โ†’ "is this package alive?" --- ### โš™๏ธ Input configuration | Field | Type | Default | Description | |-------|------|---------|-------------| | `searchTerms` | `string[]` | `[]` | NPM registry search queries (paginated 250/page). | | `packageNames` | `string[]` | `[]` | Direct package names (incl. `@scope/name`). | | `maintainer` | `string` | `""` | Search-only filter: `maintainer:`. | | `scope` | `string` | `""` | Search-only filter: `scope:` (without `@`). | | `keywords` | `string[]` | `[]` | Search-only filter: `keywords:` for each entry. | | `maxResultsPerSearch` | `integer` | `100` | Hard cap per search term. | | `fetchPackageDetails` | `boolean` | `true` | Pull full registry doc per package โ€” adds maintainers, dist-tags, repository, license, version history, dependencies, deprecation, file engines, exports. | | `fetchDownloadsStats` | `boolean` | `true` | Add last-day / week / month / year download counts via the npmjs stats API. | | `fetchDownloadsHistory` | `boolean` | `false` | Pull per-day downloads time series โ€” adds `downloadsHistory: [{day,downloads},โ€ฆ]`. | | `downloadsHistoryRange` | `string` | `"last-month"` | Range for history (`last-week` / `last-month` / `last-year` or `YYYY-MM-DD:YYYY-MM-DD`). | | `fetchReadme` | `boolean` | `false` | Include the package's raw README markdown in each record (requires `fetchPackageDetails`). | | `minMonthlyDownloads` | `integer` | `0` | Client-side floor โ€” drop packages below this monthly download count. | | `includeDeprecated` | `boolean` | `true` | Set to `false` to skip packages marked deprecated by maintainers. | | `minVersionPublishDate` | `string` | `null` | Drop packages whose latest version was published before this date (`YYYY-MM-DD`). | --- ### ๐Ÿ“ฆ Output fields | Field | Description | Example | |-------|-------------|---------| | `name` | Package name | `"apify"` | | `scope` | `@scope` (if scoped) | `"@apify"` | | `version` | Latest published version | `"3.7.2"` | | `description` | Short description | `"The scalable web crawling..."` | | `keywords` | Author-supplied keywords | `["headless","chrome","puppeteer"]` | | `license` | SPDX license ID | `"Apache-2.0"` | | `homepage` | Project homepage | `"https://docs.apify.com/sdk/js"` | | `repositoryUrl` | Source repository URL | `"https://github.com/apify/apify-sdk-js"` | | `repositoryType` | `git`, `svn`, etc. | `"git"` | | `bugsUrl` | Bug tracker URL | `"https://github.com/.../issues"` | | `npmUrl` | NPM page URL | `"https://www.npmjs.com/package/apify"` | | `publishedAt` | Latest version publish date | `"2026-05-18T..."` | | `createdAt` | Original creation date | `"2017-11-...":` | | `lastModified` | Last modification | `"2026-05-18T..."` | | `maintainers` | List of maintainer usernames | `["mtrunkat","jancurn"]` | | `maintainersCount` | Count | `11` | | `publisherUsername` | Last publisher | `"GitHub Actions"` | | `author` | Author display | `"Apify Technologies s.r.o."` | | `distTags` | All dist-tags | `{"latest":"3.7.2","beta":"3.8.0-beta.1"}` | | `versionCount` | Total published versions | `1082` | | `versionHistory` | All versions + publish dates | `[{version,publishedAt}, โ€ฆ]` | | `engines` | Node/npm engine constraints | `{"node":">=18"}` | | `exports` | Package `exports` map | `{...}` | | `main` | Main entry point | `"build/index.js"` | | `type` | `"module"` / `"commonjs"` | `"module"` | | `dependencies` | Runtime deps | `{...}` | | `devDependencies` | Dev deps | `{...}` | | `peerDependencies` | Peer deps | `{...}` | | `optionalDependencies` | Optional deps | `{...}` | | `dependencyCount` | Runtime dep count | `12` | | `deprecated` | Deprecation message | `null` | | `isDeprecated` | Bool | `false` | | `tarballUrl` | Direct tarball | `"https://registry.npmjs.org/.../apify-3.7.2.tgz"` | | `unpackedSize` | Unpacked size in bytes | `1234567` | | `fileCount` | File count in tarball | `42` | | `shasum` | Tarball SHA-1 | `"abc..."` | | `integrity` | SRI integrity hash | `"sha512-..."` | | `dailyDownloads` | Last-day downloads | `1247` | | `weeklyDownloads` | Last-week downloads | `44630` | | `monthlyDownloads` | Last-month downloads | `153258` | | `yearlyDownloads` | Last-year downloads | `1900000` | | `downloadsHistory` | Per-day series (optional) | `[{day:"2026-05-01",downloads:5200}, โ€ฆ]` | | `dependentsCount` | Packages depending on this | `77` | | `searchScore` | NPM search relevance score | `1422.05` | | `readme` | Full README markdown (optional) | `"## Apify SDK\nโ€ฆ"` | | `scrapedAt` | UTC scrape timestamp | `"2026-05-18T07:30:00Z"` | --- ### ๐Ÿงช Example inputs #### 1. Top scraping packages with full stats ```json { "searchTerms": ["scraper", "crawler", "puppeteer"], "maxResultsPerSearch": 50, "fetchPackageDetails": true, "fetchDownloadsStats": true, "minMonthlyDownloads": 1000 } ```` #### 2. All packages in the `@apify` scope ```json { "searchTerms": ["scope:apify"], "scope": "apify", "maxResultsPerSearch": 500 } ``` #### 3. Direct package list with downloads history ```json { "packageNames": ["react", "vue", "svelte", "solid-js", "preact", "lit"], "fetchPackageDetails": true, "fetchDownloadsStats": true, "fetchDownloadsHistory": true, "downloadsHistoryRange": "last-year" } ``` #### 4. Fresh packages only (published in 2026) ```json { "searchTerms": ["typescript starter"], "maxResultsPerSearch": 200, "fetchPackageDetails": true, "minVersionPublishDate": "2026-01-01" } ``` #### 5. Healthy + non-deprecated React UI libraries ```json { "searchTerms": ["react component library"], "keywords": ["react", "ui"], "maxResultsPerSearch": 200, "includeDeprecated": false, "minMonthlyDownloads": 10000 } ``` #### 6. SBOM-style: full dependency map for a list of packages ```json { "packageNames": ["next", "@types/react", "tailwindcss", "drizzle-orm"], "fetchPackageDetails": true, "fetchDownloadsStats": false, "fetchReadme": true } ``` #### 7. OSS sponsorship outreach: maintainers of top scraping libs ```json { "searchTerms": ["scraper", "crawler"], "maxResultsPerSearch": 1000, "fetchPackageDetails": true, "fetchDownloadsStats": true, "minMonthlyDownloads": 5000, "includeDeprecated": false } ``` *** ### ๐Ÿง  How it works 1. **Search** โ†’ `GET https://registry.npmjs.org/-/v1/search?text=&size=250&from=N` paginates 250 packages per page. 2. **Per-package full doc** โ†’ `GET https://registry.npmjs.org/` returns every published version + repository + maintainers + license + time map. 3. **Downloads point stats** โ†’ `GET https://api.npmjs.org/downloads/point//` for each of `last-day`, `last-week`, `last-month`, `last-year`. 4. **Downloads time series** โ†’ `GET https://api.npmjs.org/downloads/range//` returns one entry per day. 5. **Dedup** โ€” names are tracked across search terms and direct lists to avoid double-processing. No authentication. NPM's registry + stats APIs are public by design. *** ### ๐Ÿ›‘ Limits & notes - **NPM stats API rate limit**: ~5 req/sec per IP under normal conditions. The actor uses sequential per-package enrichment with backoff retries. - **`dependentsCount`** in the search snippet is approximate; for exact dependents enumeration use the `https://www.npmjs.com/browse/depended/{pkg}` page (not yet supported โ€” open a feature request). - **`readme`** can be large (some packages ship 50+ KB markdown). Disable for large runs unless needed. - **Scoped private packages** are not returned. Public scopes (`@types/*`, `@apify/*`, etc.) are fully accessible. - **Search relevance score** is NPM's internal ranking โ€” useful for ordering but not directly comparable across queries. *** ### ๐Ÿ’ฐ Pricing Monetized via **pay-per-event** on Apify โ€” pay per package record saved. NPM registry + stats APIs are free. *** ### โ“ FAQ **Does this work for private NPM registries (GitHub Packages, JFrog)?** Not by default. The actor targets the public `registry.npmjs.org`. Open an issue to add an `auth_token` + custom registry URL feature. **Can I get exact lists of packages that depend on package X?** Not yet โ€” NPM no longer exposes a stable "dependents" API. The search snippet returns an approximate count. For full reverse-dependency enumeration consider GitHub code search. **Can I export to CSV / Excel?** Yes โ€” every Apify dataset can be exported in CSV, Excel, XML, JSONL, or RSS from the run page or via the API. **How is this different from `npm-registry-fetch` or `pacote`?** Those are Node libraries to call the same endpoints from your own code. This actor adds: cross-source merging, pagination guardrails, normalized output, optional download history, deprecation/staleness filtering and Apify-native scheduling, webhooks, dataset views. **Does it cover PyPI / RubyGems / Cargo / Maven?** No โ€” JavaScript NPM only. Each ecosystem can be added as a sibling actor. **Does it download tarballs?** No โ€” only metadata. `tarballUrl` is provided for downstream fetching if needed. *** ### ๐Ÿ”— Related actors - `logiover/github-repository-scraper` โ€” combine NPM `repositoryUrl` with GitHub for stars + contributors - `logiover/website-contact-scraper` โ€” enrich `homepage` URLs with maintainer contact emails for outreach - `logiover/sitemap-to-url-crawler` โ€” crawl each package's docs site for additional content - `logiover/devto-articles-scraper` โ€” track how often each package is discussed on Dev.to *** ### ๐Ÿ†˜ Support Need PyPI, RubyGems, Cargo or Maven equivalent? Open an issue on the actor's Apify page. *** ### Changelog - **2026-05-20** โ€” Maintenance pass: reviewed the input schema and default values for a smooth one-click start, and rebuilt the Actor on the latest base image. *Last reviewed: 2026-05-20.* # Actor input Schema ## `searchTerms` (type: `array`): Free-text search queries against the NPM registry (`https://registry.npmjs.org/-/v1/search`). Each term paginates 250 results per page. Examples: \['scraper', 'crawler'], \['react component library'], \['stripe webhook']. Leave empty if you supply package names directly. ## `packageNames` (type: `array`): Direct NPM package names to fetch. Includes scoped packages: `@apify/scraper-tools`, `react`, `next`, `@types/node`. Faster and more predictable than search. ## `maintainer` (type: `string`): Restrict search results to packages maintained by a specific username. The NPM search syntax appends `author:` or `maintainer:` to the query. ## `scope` (type: `string`): Restrict search to a specific scope (org). Pass without the leading `@`. Examples: 'apify', 'sentry', 'storybook'. ## `keywords` (type: `array`): Add `keywords:` filters to each search query. Useful to narrow noisy queries. Examples: \['typescript'], \['react', 'hooks']. ## `maxResultsPerSearch` (type: `integer`): Hard cap per search term. NPM search returns up to 250 per page; the actor auto-paginates. ## `fetchPackageDetails` (type: `boolean`): When enabled, the actor calls `https://registry.npmjs.org/{pkg}` for each package to retrieve full metadata: maintainers list, dist-tags, repository URL, homepage, license, engines, exports map, deprecation status, README content, and per-version publish times. ## `fetchDownloadsStats` (type: `boolean`): When enabled, the actor calls `https://api.npmjs.org/downloads/point/{period}/{pkg}` for each package and adds last-day, last-week, last-month and last-year download counts. ## `fetchDownloadsHistory` (type: `boolean`): When enabled (and `downloadsHistoryRange` is set), fetches the daily downloads time series from `https://api.npmjs.org/downloads/range/{range}/{pkg}`. Adds one record array per package with date + downloads pairs. Useful for trend analytics. ## `downloadsHistoryRange` (type: `string`): Range for `fetchDownloadsHistory`. Either preset (`last-week`, `last-month`, `last-year`) or explicit (`2026-01-01:2026-05-18`). ## `fetchReadme` (type: `boolean`): When enabled (requires `fetchPackageDetails`), the package's full README markdown content is included in the output record. ## `minMonthlyDownloads` (type: `integer`): Drop packages with fewer monthly downloads than this. Useful to filter out abandoned / experimental packages. Requires `fetchDownloadsStats`. ## `includeDeprecated` (type: `boolean`): When `false`, skips packages marked as deprecated by their maintainer. ## `minVersionPublishDate` (type: `string`): Only keep packages whose latest version was published on or after this date. Useful for surfacing 'fresh' packages. Requires `fetchPackageDetails`. ## Actor input object example ```json { "searchTerms": [ "scraper" ], "packageNames": [], "maintainer": "", "scope": "", "keywords": [], "maxResultsPerSearch": 100, "fetchPackageDetails": true, "fetchDownloadsStats": true, "fetchDownloadsHistory": false, "downloadsHistoryRange": "last-month", "fetchReadme": false, "minMonthlyDownloads": 0, "includeDeprecated": true, "minVersionPublishDate": null } ``` # Actor output Schema ## `name` (type: `string`): Package name ## `version` (type: `string`): Latest version ## `description` (type: `string`): Description ## `scope` (type: `string`): @scope ## `license` (type: `string`): License ## `homepage` (type: `string`): Homepage URL ## `repositoryUrl` (type: `string`): Repository URL ## `npmUrl` (type: `string`): NPM page URL ## `weeklyDownloads` (type: `string`): Weekly downloads ## `monthlyDownloads` (type: `string`): Monthly downloads ## `dependentsCount` (type: `string`): Dependents count ## `publishedAt` (type: `string`): Latest publish date ## `maintainersCount` (type: `string`): Maintainer count ## `deprecated` (type: `string`): Deprecation message ## `scrapedAt` (type: `string`): Scrape timestamp # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "scraper" ] }; // Run the Actor and wait for it to finish const run = await client.actor("logiover/npm-package-intelligence-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["scraper"] } # Run the Actor and wait for it to finish run = client.actor("logiover/npm-package-intelligence-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "scraper" ] }' | apify call logiover/npm-package-intelligence-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=logiover/npm-package-intelligence-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NPM Package Scraper โ€” Downloads, Maintainers, Deps & SBOM", "description": "Export every NPM package by keyword, maintainer, scope or name. Get version, license, repo URL, maintainers, daily/weekly/monthly downloads, dependents, deprecation, full deps, version history. Official NPM registry + stats API. For devtool intel, SBOM and OSS outreach.", "version": "1.0", "x-build-id": "5EBzSWjmDjh6u8abS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~npm-package-intelligence-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-npm-package-intelligence-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/logiover~npm-package-intelligence-scraper/runs": { "post": { "operationId": "runs-sync-logiover-npm-package-intelligence-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/logiover~npm-package-intelligence-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-npm-package-intelligence-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "Free-text search queries against the NPM registry (`https://registry.npmjs.org/-/v1/search`). Each term paginates 250 results per page. Examples: ['scraper', 'crawler'], ['react component library'], ['stripe webhook']. Leave empty if you supply package names directly.", "default": [], "items": { "type": "string" } }, "packageNames": { "title": "Package Names", "type": "array", "description": "Direct NPM package names to fetch. Includes scoped packages: `@apify/scraper-tools`, `react`, `next`, `@types/node`. Faster and more predictable than search.", "default": [], "items": { "type": "string" } }, "maintainer": { "title": "Maintainer / Author Filter (search-only)", "type": "string", "description": "Restrict search results to packages maintained by a specific username. The NPM search syntax appends `author:` or `maintainer:` to the query.", "default": "" }, "scope": { "title": "Scope Filter (search-only)", "type": "string", "description": "Restrict search to a specific scope (org). Pass without the leading `@`. Examples: 'apify', 'sentry', 'storybook'.", "default": "" }, "keywords": { "title": "Keyword Filter (search-only)", "type": "array", "description": "Add `keywords:` filters to each search query. Useful to narrow noisy queries. Examples: ['typescript'], ['react', 'hooks'].", "default": [], "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max Results Per Search Term", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap per search term. NPM search returns up to 250 per page; the actor auto-paginates.", "default": 100 }, "fetchPackageDetails": { "title": "Fetch Full Package Details", "type": "boolean", "description": "When enabled, the actor calls `https://registry.npmjs.org/{pkg}` for each package to retrieve full metadata: maintainers list, dist-tags, repository URL, homepage, license, engines, exports map, deprecation status, README content, and per-version publish times.", "default": true }, "fetchDownloadsStats": { "title": "Fetch Downloads Stats", "type": "boolean", "description": "When enabled, the actor calls `https://api.npmjs.org/downloads/point/{period}/{pkg}` for each package and adds last-day, last-week, last-month and last-year download counts.", "default": true }, "fetchDownloadsHistory": { "title": "Fetch Downloads History (per-day series)", "type": "boolean", "description": "When enabled (and `downloadsHistoryRange` is set), fetches the daily downloads time series from `https://api.npmjs.org/downloads/range/{range}/{pkg}`. Adds one record array per package with date + downloads pairs. Useful for trend analytics.", "default": false }, "downloadsHistoryRange": { "title": "Downloads History Range", "type": "string", "description": "Range for `fetchDownloadsHistory`. Either preset (`last-week`, `last-month`, `last-year`) or explicit (`2026-01-01:2026-05-18`).", "default": "last-month" }, "fetchReadme": { "title": "Include README Content", "type": "boolean", "description": "When enabled (requires `fetchPackageDetails`), the package's full README markdown content is included in the output record.", "default": false }, "minMonthlyDownloads": { "title": "Minimum Monthly Downloads (client-side filter)", "minimum": 0, "type": "integer", "description": "Drop packages with fewer monthly downloads than this. Useful to filter out abandoned / experimental packages. Requires `fetchDownloadsStats`.", "default": 0 }, "includeDeprecated": { "title": "Include Deprecated Packages", "type": "boolean", "description": "When `false`, skips packages marked as deprecated by their maintainer.", "default": true }, "minVersionPublishDate": { "title": "Minimum Latest-Version Publish Date (ISO)", "type": "string", "description": "Only keep packages whose latest version was published on or after this date. Useful for surfacing 'fresh' packages. Requires `fetchPackageDetails`.", "default": null } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```