NPM Packages Scraper - Versions, Authors & Scores

Here is one real result, with every field the actor returns (the maintainers and maintainerEmails arrays are trimmed to 3 of the 12 real entries for length; the actor returns all of them):

{
  "name": "@risingstack/react-easy-state",
  "version": "6.3.0",
  "description": "React state management with a minimal API. Made with ES6 Proxies.",
  "keywords": [
    "observable",
    "react-component",
    "react",
    "reactjs",
    "reactive",
    "model",
    "frp",
    "functional-reactive-programming",
    "state management",
    "es6 proxy"
  ],
  "author": null,
  "publisher": "solkimicreb",
  "date": "2020-04-24T09:39:26.695Z",
  "npmUrl": "https://www.npmjs.com/package/@risingstack/react-easy-state",
  "homepage": "https://github.com/RisingStack/react-easy-state#readme",
  "repository": "git+https://github.com/RisingStack/react-easy-state.git",
  "bugs": "https://github.com/RisingStack/react-easy-state/issues",
  "scoreFinal": 339.3832,
  "scoreQuality": 1,
  "scorePopularity": 1,
  "scoreMaintenance": 1,
  "searchScore": 339.3832,
  "downloadsLastWeek": 16535,
  "downloadsLastMonth": 70922,
  "license": "MIT",
  "latestVersion": "6.3.0",
  "maintainers": [
    { "name": "paldiana01", "email": "diana.pal@risingstack.com" },
    { "name": "risingnpm", "email": "info@risingstack.com" },
    { "name": "gergelyke", "email": "mail@nemethgergely.com" }
  ],
  "maintainerEmails": [
    "diana.pal@risingstack.com",
    "info@risingstack.com",
    "mail@nemethgergely.com"
  ],
  "authorEmail": "miklos.bertalan@risingstack.com",
  "dependenciesCount": 1,
  "unpackedSize": 188166,
  "fileCount": 16,
  "tarball": "https://registry.npmjs.org/@risingstack/react-easy-state/-/react-easy-state-6.3.0.tgz",
  "enginesNode": ">=6.0.0",
  "deprecated": false,
  "source": "npm",
  "observedAt": "2026-08-10T14:19:09.212Z"
}

The most complete npm package scraper available. It returns every field the public npm registry search exposes for each package, plus enrichment fields (weekly and monthly downloads, license, maintainer contacts, dependency count, package size and distribution details), and gives you a keyword search plus a stats toggle to pull exactly the packages you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches the public npm registry with your keyword, paginates through the matching packages, and writes one normalized record per package to the run's dataset. Each record carries the package name, current version, description, keywords, publisher, links, and the npm quality/popularity/maintenance scores.

When includeStats is on (the default), every package is enriched with weekly and monthly download counts, its license, the full maintainer list with contact emails, the author email, dependency count, unpacked size, file count, the tarball URL, the required Node engine and whether the package is deprecated. Turn includeStats off for a faster keyword-only run. Missing source values are returned as null, never invented.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 packages matching "react state management" with download stats and maintainer contacts.

{
  "searchQuery": "react state management",
  "maxPackages": 10,
  "includeStats": true
}

Every input field is optional. With an empty input the actor searches for react and returns up to 10 packages with stats.

Input reference

Field	Type	Required	Default	Description
searchQuery	string	no	react	Keyword to search npm packages, for example http client, react state management, csv parser.
maxPackages	integer	no	10	Maximum number of packages to collect (1 to 10000).
includeStats	boolean	no	true	Enrich every package with download counts, license, maintainer contacts, dependency count and package size. Turn off for a faster keyword-only run.

Output reference

One dataset item per package. Types: string, number, boolean, array, object, or null when the source value is absent.

Field	Type	Description
name	string	Package name (unique per package), for example @risingstack/react-easy-state.
version	string	Package version returned by search.
description	string	Package description.
keywords	string[]	Package keywords. Empty array when none.
author	string	Author name from search metadata, or null.
publisher	string	npm username of the last publisher.
date	string	ISO 8601 date the version was published.
npmUrl	string	Package page on npmjs.com.
homepage	string	Homepage link, or null.
repository	string	Source repository URL, or null.
bugs	string	Issue tracker URL, or null.
scoreFinal	number	npm final search score.
scoreQuality	number	npm quality sub-score.
scorePopularity	number	npm popularity sub-score.
scoreMaintenance	number	npm maintenance sub-score.
searchScore	number	Raw search relevance score.
downloadsLastWeek	number	Downloads in the last week (stats on), else null.
downloadsLastMonth	number	Downloads in the last month (stats on), else null.
license	string	SPDX license string (stats on), else null.
latestVersion	string	Latest published version from dist-tags (stats on), else null.
maintainers	array	Maintainer objects with name and email (stats on).
maintainerEmails	string[]	Flat list of maintainer emails (stats on).
authorEmail	string	Author email (stats on), or null.
dependenciesCount	number	Number of runtime dependencies (stats on), or null.
unpackedSize	number	Unpacked size of the latest version in bytes (stats on), or null.
fileCount	number	File count in the latest version tarball (stats on), or null.
tarball	string	Tarball download URL (stats on), or null.
enginesNode	string	Required Node engine range (stats on), or null.
deprecated	boolean	Whether the latest version is deprecated (stats on), or null.
source	string	Always npm.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	Present only on a failed run, when a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"searchQuery": "react state management", "maxPackages": 10, "includeStats": true}):

{
  "name": "unstated-next",
  "version": "1.1.0",
  "description": "200 bytes to never think about React state management libraries ever again",
  "keywords": [],
  "author": null,
  "publisher": "thejameskyle",
  "date": "2019-05-13T23:34:47.580Z",
  "npmUrl": "https://www.npmjs.com/package/unstated-next",
  "homepage": null,
  "repository": null,
  "bugs": null,
  "scoreFinal": 367.1756,
  "scoreQuality": 1,
  "scorePopularity": 1,
  "scoreMaintenance": 1,
  "searchScore": 367.1756,
  "downloadsLastWeek": 103634,
  "downloadsLastMonth": 392723,
  "license": "MIT",
  "latestVersion": "1.1.0",
  "maintainers": [
    { "name": "thejameskyle", "email": "me@thejameskyle.com" }
  ],
  "maintainerEmails": ["me@thejameskyle.com"],
  "authorEmail": null,
  "dependenciesCount": 0,
  "unpackedSize": 68969,
  "fileCount": 19,
  "tarball": "https://registry.npmjs.org/unstated-next/-/unstated-next-1.1.0.tgz",
  "enginesNode": null,
  "deprecated": false,
  "source": "npm",
  "observedAt": "2026-08-10T14:19:09.212Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~npm-packages-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQuery":"react state management","maxPackages":10,"includeStats":true}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~npm-packages-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQuery":"http client","maxPackages":100}'

Apify CLI:

apify call scrapers_lat/npm-packages-scraper \
  --input '{"searchQuery":"csv parser","includeStats":false}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per package record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors before any package is collected, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxPackages.

FAQ and troubleshooting

A run returned 0 records. Why? The keyword matched no packages in the npm registry. Try a broader keyword. Zero-result runs are not charged.

Why are download counts and maintainer emails null? includeStats was off. Turn it on to enrich every package with downloads, license, maintainer contacts and package size.

How current are the download numbers? downloadsLastWeek and downloadsLastMonth come from the npm downloads API at run time and cover the trailing week and month.

Can I pull a large set of packages? Yes. Raise maxPackages (up to 10000). The actor paginates the registry search automatically. Free Apify plans are capped at 10 per run.

Is this an official npm tool? No. This actor is independent and has no affiliation with npm, Inc. or GitHub. It reads only data that the public npm registry exposes.

Related scrapers

• GitHub Repositories Scraper: Search and extract GitHub repositories with stars and metadata.
• GitHub Contributor Contacts Scraper: Contributor names and public emails from a repo.
• crates.io Scraper: Rust crate metadata, versions and downloads.
• Docker Hub Images Scraper: Docker Hub image metadata, tags and pull counts.
• Hugging Face Models Scraper: Model cards, downloads and metadata.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with npm, Inc. or GitHub. Accesses only publicly available data from the npm registry.