# Npm Package Intelligence (`viralanalyzer/npm-package-intelligence`) Actor

Extract NPM package data: downloads, dependencies, versions, maintainers, and README. Track JavaScript ecosystem trends.

- **URL**: https://apify.com/viralanalyzer/npm-package-intelligence.md
- **Developed by:** [viralanalyzer](https://apify.com/viralanalyzer) (community)
- **Categories:** Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $15.75 / 1,000 package scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Intelligence — Package Data, Scores & Download Stats

> 🔗 [View on Apify Store](https://apify.com/viralanalyzer/npm-package-intelligence) | 🇺🇸 English | [🇧🇷 Português](#português)

Scrape **NPM package metadata, quality scores, and download statistics** using the public NPM registry API. Search by **keyword**, browse **popular packages**, or get full details for **specific package names** — including weekly/monthly downloads, maintainer info, and NPM scores.

### ✨ Features

- 🔍 **Keyword search** — Find packages by keyword with NPM's search API
- 🏆 **Popular packages** — Browse top packages sorted by popularity score
- 📦 **Specific packages** — Get full registry details for exact package names
- 📊 **Download stats** — Weekly download counts and daily monthly breakdown
- ⭐ **NPM scores** — Quality, popularity, maintenance, and overall scores
- 👥 **Maintainer info** — Publisher username and maintainer count
- 🔗 **Repository links** — Homepage, GitHub repo, and NPM page URLs
- 🛡️ **Anti-placeholder guardrails** — Only real data, never fake results

### 📥 Input

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `mode` | String | Yes | `search` | Scraping mode: `search`, `popular`, or `by_packages` |
| `searchQueries` | Array | In `search`/`popular` modes | — | Keywords to search for (max 10 queries) |
| `packageNames` | Array | In `by_packages` mode | — | Exact NPM package names (max 200) |
| `maxItems` | Integer | No | `50` | Maximum packages per search query (1–200) |
| `includeDownloads` | Boolean | No | `true` | Fetch weekly and monthly download counts |

#### Input Example
```json
{
    "mode": "search",
    "searchQueries": ["react", "machine learning"],
    "maxItems": 25,
    "includeDownloads": true
}
````

### 📤 Output

| Field | Type | Description |
|-------|------|-------------|
| `name` | String | Package name |
| `version` | String | Latest version number |
| `description` | String | Package description |
| `keywords` | Array | Package keywords/tags |
| `homepage` | String | Project homepage URL |
| `repositoryUrl` | String | Source code repository URL |
| `npmUrl` | String | NPM package page URL |
| `weeklyDownloads` | Integer | Downloads in the last 7 days |
| `monthlyDownloads` | Array | Daily download counts for the last 30 days |
| `publisher` | String | Publisher username |
| `maintainerCount` | Integer | Number of maintainers |
| `qualityScore` | Float | NPM quality score (0–1) |
| `popularityScore` | Float | NPM popularity score (0–1) |
| `maintenanceScore` | Float | NPM maintenance score (0–1) |
| `overallScore` | Float | NPM overall score (0–1) |
| `lastPublished` | String | Date of last publish (ISO 8601) |
| `license` | String | Package license (in `by_packages` mode) |
| `created` | String | Package creation date (in `by_packages` mode) |
| `dependencyCount` | Integer | Total dependencies (in `by_packages` mode) |
| `platform` | String | Always `npm` |
| `scrapedAt` | String | Timestamp of data extraction (ISO 8601) |

#### Output Example

```json
{
    "name": "react",
    "version": "19.0.0",
    "description": "The library for web and native user interfaces.",
    "keywords": ["react"],
    "homepage": "https://react.dev/",
    "repositoryUrl": "https://github.com/facebook/react",
    "npmUrl": "https://www.npmjs.com/package/react",
    "weeklyDownloads": 27845631,
    "monthlyDownloads": [
        { "day": "2026-02-04", "downloads": 4125890 },
        { "day": "2026-02-05", "downloads": 4356712 }
    ],
    "publisher": "",
    "maintainerCount": 3,
    "qualityScore": null,
    "popularityScore": null,
    "maintenanceScore": null,
    "overallScore": null,
    "license": "MIT",
    "created": "2011-10-26T17:46:21.942Z",
    "lastPublished": "2025-12-05T20:12:45.876Z",
    "dependencyCount": 2,
    "platform": "npm",
    "scrapedAt": "2026-03-06T14:30:00.000Z"
}
```

### 📋 Use Cases

- 📊 **Technology radar** — Track adoption trends of frameworks and libraries by download volume
- 🏢 **Competitive analysis** — Compare similar packages by quality, popularity, and maintenance scores
- 🔍 **Dependency auditing** — Analyze package health metrics before adding to your project
- 📈 **Market research** — Identify growing ecosystems and emerging tools in the JavaScript world
- 🤖 **Automated reporting** — Feed package data into dashboards for DevOps or engineering teams
- 📰 **Developer newsletters** — Curate trending and noteworthy packages for weekly digests

### ❓ FAQ

**Q: What is the difference between `search`, `popular`, and `by_packages` modes?**
A: `search` finds packages by keyword (sorted by relevance), `popular` sorts results by NPM popularity score, and `by_packages` fetches full registry details for specific package names you provide.

**Q: Why are some scores null in `by_packages` mode?**
A: Quality, popularity, maintenance, and overall scores are only available through the NPM search API. In `by_packages` mode, data is fetched directly from the registry, which provides richer details (license, creation date, dependencies) but not the search-specific scores.

**Q: Does enabling `includeDownloads` make the scrape slower?**
A: Yes, slightly. Each package requires two extra API calls (weekly + monthly downloads) with a 500ms rate-limit delay. For 50 packages, this adds about 50 seconds of extra runtime.

**Q: Can I scrape scoped packages (e.g., @angular/core)?**
A: Yes, in `by_packages` mode you can provide scoped package names like `@angular/core`, `@types/react`, etc. The actor handles URL encoding automatically.

**Q: What happens if a package name does not exist?**
A: The actor logs a warning and skips the missing package. If all packages are missing and zero results are found, the actor throws an explicit error.

### 💰 Pricing

This actor uses **Pay Per Event (PPE)** pricing:

| Metric | Cost |
|--------|------|
| Per package scraped | $0.03 |

### 🔗 Related Actors

- [ArXiv Paper Intelligence](https://apify.com/viralanalyzer/arxiv-paper-intelligence) — Scrape academic papers from ArXiv with full metadata
- [GitHub Trending Scraper](https://apify.com/viralanalyzer/github-trending-scraper) — Trending repositories and developers on GitHub
- [Stack Overflow Scraper](https://apify.com/viralanalyzer/stackoverflow-scraper) — Questions, answers, and tags from Stack Overflow
- [Wikipedia Trending Pages](https://apify.com/viralanalyzer/wikipedia-trending) — Most-viewed Wikipedia articles and pageview history

### 📝 Changelog

#### v1.0 (Current)

- ✅ Search packages by keyword with NPM search API
- ✅ Browse popular packages sorted by popularity score
- ✅ Fetch full registry details for specific package names
- ✅ Weekly and monthly download statistics
- ✅ NPM quality, popularity, maintenance, and overall scores
- ✅ Deduplication by package name
- ✅ Anti-placeholder guardrails — real data only
- ✅ PPE billing via Actor.charge()

***

<a name="português"></a>

## 📦 NPM Package Intelligence — Dados de Pacotes, Scores e Estatísticas de Download

> [🇺🇸 English](#-npm-package-intelligence--package-data-scores--download-stats) | 🇧🇷 Português

Extraia **metadados, scores de qualidade e estatísticas de download de pacotes NPM** usando a API pública do registro NPM. Pesquise por **palavra-chave**, navegue por **pacotes populares**, ou obtenha detalhes completos de **pacotes específicos** — incluindo downloads semanais/mensais, informações de mantenedores e scores do NPM.

### ✨ Funcionalidades

- 🔍 **Pesquisa por palavra-chave** — Encontre pacotes por palavra-chave com a API de busca do NPM
- 🏆 **Pacotes populares** — Navegue pelos pacotes mais populares ordenados por score de popularidade
- 📦 **Pacotes específicos** — Obtenha detalhes completos do registro para nomes exatos de pacotes
- 📊 **Estatísticas de download** — Contagem semanal e detalhamento diário mensal
- ⭐ **Scores do NPM** — Qualidade, popularidade, manutenção e score geral
- 👥 **Informações de mantenedores** — Nome de usuário do publicador e número de mantenedores
- 🔗 **Links de repositório** — URLs da homepage, repositório GitHub e página NPM
- 🛡️ **Proteção anti-placeholder** — Apenas dados reais, nunca resultados falsos

### 📥 Entrada

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|-----------|------|-------------|--------|-----------|
| `mode` | String | Sim | `search` | Modo de extração: `search`, `popular` ou `by_packages` |
| `searchQueries` | Array | Nos modos `search`/`popular` | — | Palavras-chave para pesquisar (máximo 10 consultas) |
| `packageNames` | Array | No modo `by_packages` | — | Nomes exatos de pacotes NPM (máximo 200) |
| `maxItems` | Integer | Não | `50` | Máximo de pacotes por consulta de busca (1–200) |
| `includeDownloads` | Boolean | Não | `true` | Buscar contagens de download semanais e mensais |

#### Exemplo de Entrada

```json
{
    "mode": "search",
    "searchQueries": ["react", "machine learning"],
    "maxItems": 25,
    "includeDownloads": true
}
```

### 📤 Saída

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `name` | String | Nome do pacote |
| `version` | String | Número da versão mais recente |
| `description` | String | Descrição do pacote |
| `keywords` | Array | Palavras-chave/tags do pacote |
| `homepage` | String | URL da homepage do projeto |
| `repositoryUrl` | String | URL do repositório de código-fonte |
| `npmUrl` | String | URL da página do pacote no NPM |
| `weeklyDownloads` | Integer | Downloads nos últimos 7 dias |
| `monthlyDownloads` | Array | Contagem diária de downloads dos últimos 30 dias |
| `publisher` | String | Nome de usuário do publicador |
| `maintainerCount` | Integer | Número de mantenedores |
| `qualityScore` | Float | Score de qualidade do NPM (0–1) |
| `popularityScore` | Float | Score de popularidade do NPM (0–1) |
| `maintenanceScore` | Float | Score de manutenção do NPM (0–1) |
| `overallScore` | Float | Score geral do NPM (0–1) |
| `lastPublished` | String | Data da última publicação (ISO 8601) |
| `license` | String | Licença do pacote (no modo `by_packages`) |
| `created` | String | Data de criação do pacote (no modo `by_packages`) |
| `dependencyCount` | Integer | Total de dependências (no modo `by_packages`) |
| `platform` | String | Sempre `npm` |
| `scrapedAt` | String | Timestamp da extração dos dados (ISO 8601) |

#### Exemplo de Saída

```json
{
    "name": "react",
    "version": "19.0.0",
    "description": "The library for web and native user interfaces.",
    "keywords": ["react"],
    "homepage": "https://react.dev/",
    "repositoryUrl": "https://github.com/facebook/react",
    "npmUrl": "https://www.npmjs.com/package/react",
    "weeklyDownloads": 27845631,
    "monthlyDownloads": [
        { "day": "2026-02-04", "downloads": 4125890 },
        { "day": "2026-02-05", "downloads": 4356712 }
    ],
    "publisher": "",
    "maintainerCount": 3,
    "qualityScore": null,
    "popularityScore": null,
    "maintenanceScore": null,
    "overallScore": null,
    "license": "MIT",
    "created": "2011-10-26T17:46:21.942Z",
    "lastPublished": "2025-12-05T20:12:45.876Z",
    "dependencyCount": 2,
    "platform": "npm",
    "scrapedAt": "2026-03-06T14:30:00.000Z"
}
```

### 📋 Casos de Uso

- 📊 **Radar tecnológico** — Acompanhe tendências de adoção de frameworks e bibliotecas por volume de downloads
- 🏢 **Análise competitiva** — Compare pacotes similares por qualidade, popularidade e scores de manutenção
- 🔍 **Auditoria de dependências** — Analise métricas de saúde de pacotes antes de adicioná-los ao seu projeto
- 📈 **Pesquisa de mercado** — Identifique ecossistemas em crescimento e ferramentas emergentes no mundo JavaScript
- 🤖 **Relatórios automatizados** — Alimente dados de pacotes em dashboards para equipes de DevOps ou engenharia
- 📰 **Newsletters para devs** — Selecione pacotes em tendência e notáveis para resumos semanais

### ❓ Perguntas Frequentes

**P: Qual é a diferença entre os modos `search`, `popular` e `by_packages`?**
R: `search` encontra pacotes por palavra-chave (ordenados por relevância), `popular` ordena resultados pelo score de popularidade do NPM, e `by_packages` busca detalhes completos do registro para nomes de pacotes específicos que você fornecer.

**P: Por que alguns scores são null no modo `by_packages`?**
R: Os scores de qualidade, popularidade, manutenção e geral só estão disponíveis pela API de busca do NPM. No modo `by_packages`, os dados são buscados diretamente do registro, que fornece detalhes mais ricos (licença, data de criação, dependências), mas não os scores específicos da busca.

**P: Habilitar `includeDownloads` torna a extração mais lenta?**
R: Sim, ligeiramente. Cada pacote requer duas chamadas extras à API (downloads semanais + mensais) com um atraso de 500ms para rate limit. Para 50 pacotes, isso adiciona cerca de 50 segundos ao tempo de execução.

**P: Posso extrair pacotes com escopo (ex.: @angular/core)?**
R: Sim, no modo `by_packages` você pode fornecer nomes de pacotes com escopo como `@angular/core`, `@types/react`, etc. O actor lida com a codificação de URL automaticamente.

**P: O que acontece se um nome de pacote não existir?**
R: O actor registra um aviso e pula o pacote ausente. Se todos os pacotes estiverem ausentes e zero resultados forem encontrados, o actor lança um erro explícito.

### 💰 Preços

Este actor usa precificação **Pay Per Event (PPE)**:

| Métrica | Custo |
|---------|-------|
| Por pacote extraído | $0,03 |

### 🔗 Actors Relacionados

- [ArXiv Paper Intelligence](https://apify.com/viralanalyzer/arxiv-paper-intelligence) — Extraia artigos acadêmicos do ArXiv com metadados completos
- [GitHub Trending Scraper](https://apify.com/viralanalyzer/github-trending-scraper) — Repositórios e desenvolvedores em tendência no GitHub
- [Stack Overflow Scraper](https://apify.com/viralanalyzer/stackoverflow-scraper) — Perguntas, respostas e tags do Stack Overflow
- [Wikipedia Trending Pages](https://apify.com/viralanalyzer/wikipedia-trending) — Artigos mais visualizados da Wikipédia e histórico de visualizações

### 📝 Changelog

#### v1.0 (Atual)

- ✅ Pesquisa de pacotes por palavra-chave com API de busca do NPM
- ✅ Navegação por pacotes populares ordenados por score de popularidade
- ✅ Busca de detalhes completos do registro para pacotes específicos
- ✅ Estatísticas de download semanais e mensais
- ✅ Scores de qualidade, popularidade, manutenção e geral do NPM
- ✅ Deduplicação por nome de pacote
- ✅ Proteção anti-placeholder — apenas dados reais
- ✅ Cobrança PPE via Actor.charge()

# Actor input Schema

## `mode` (type: `string`):

What data to collect: search by keyword, browse popular packages, or get details for specific package names.

## `searchQueries` (type: `array`):

Keywords to search for (used in 'search' and 'popular' modes).

## `packageNames` (type: `array`):

Exact NPM package names to fetch full details for (used in 'by\_packages' mode).

## `maxItems` (type: `integer`):

Maximum number of packages to scrape per search query.

## `includeDownloads` (type: `boolean`):

Fetch weekly and monthly download counts for each package (slightly slower).

## Actor input object example

```json
{
  "mode": "search",
  "searchQueries": [
    "react",
    "machine learning"
  ],
  "packageNames": [
    "react",
    "express",
    "lodash"
  ],
  "maxItems": 10,
  "includeDownloads": true
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset containing all scraped results. Each item follows the dataset schema.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "react",
        "machine learning"
    ],
    "packageNames": [
        "react",
        "express",
        "lodash"
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("viralanalyzer/npm-package-intelligence").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": [
        "react",
        "machine learning",
    ],
    "packageNames": [
        "react",
        "express",
        "lodash",
    ],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("viralanalyzer/npm-package-intelligence").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 '{
  "searchQueries": [
    "react",
    "machine learning"
  ],
  "packageNames": [
    "react",
    "express",
    "lodash"
  ],
  "maxItems": 10
}' |
apify call viralanalyzer/npm-package-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=viralanalyzer/npm-package-intelligence",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Npm Package Intelligence",
        "description": "Extract NPM package data: downloads, dependencies, versions, maintainers, and README. Track JavaScript ecosystem trends.",
        "version": "1.0",
        "x-build-id": "QsRx0TSV10Yr18Izq"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/viralanalyzer~npm-package-intelligence/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-viralanalyzer-npm-package-intelligence",
                "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/viralanalyzer~npm-package-intelligence/runs": {
            "post": {
                "operationId": "runs-sync-viralanalyzer-npm-package-intelligence",
                "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/viralanalyzer~npm-package-intelligence/run-sync": {
            "post": {
                "operationId": "run-sync-viralanalyzer-npm-package-intelligence",
                "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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Scraping Mode",
                        "enum": [
                            "search",
                            "popular",
                            "by_packages"
                        ],
                        "type": "string",
                        "description": "What data to collect: search by keyword, browse popular packages, or get details for specific package names.",
                        "default": "search"
                    },
                    "searchQueries": {
                        "title": "Search Keywords",
                        "maxItems": 10,
                        "type": "array",
                        "description": "Keywords to search for (used in 'search' and 'popular' modes).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "packageNames": {
                        "title": "Package Names",
                        "maxItems": 200,
                        "type": "array",
                        "description": "Exact NPM package names to fetch full details for (used in 'by_packages' mode).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Maximum number of packages to scrape per search query.",
                        "default": 50
                    },
                    "includeDownloads": {
                        "title": "Include Download Stats",
                        "type": "boolean",
                        "description": "Fetch weekly and monthly download counts for each package (slightly slower).",
                        "default": true
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
