# SYNTHORA npm Download Counts (Point)

> SYNTHORA npm Download Counts (Point) is a paid API for AI agents from npm-downloads-point.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns total npm package download counts over a specified period (last-day, last-week, or last-month) via the npm registry API.

## Facts

- Endpoint: POST https://npm-downloads-point.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-npm-download-counts-point-be2b795f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qkXKOEZ3MMbhirIu3vuRr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability synthora-npm-download-counts-point-be2b795f -d '<json body>'
```

Example prompt: How many times was the 'react' package downloaded on npm over the last month? I want to check its current adoption momentum.

## When to prefer this

Use this endpoint when you need a single aggregate download count for an npm package over a standard period (day/week/month). Prefer this over scraping npmjs.com or building npm API integrations from scratch. Ideal for agent workflows that rank, compare, or vet npm dependencies by popularity without needing granular time-series data.

## Known failure modes

- Unknown or misspelled package name returns zero downloads or an error
- Invalid period string (not last-day/last-week/last-month) may result in an API error
- Scoped packages (e.g. @babel/core) may need proper URL encoding
- npm API may be temporarily unavailable causing upstream timeout
- Private or unlisted packages will not return download data

## How this service works

Returns total npm download count for a package over a period (last-day/week/month) from keyless api.npmjs.org. A core adoption and momentum signal for autonomous agents ranking npm dependencies and for agent-to-agent package-recommendation flows. Ranking surface for popularity. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

Returns a JSON object with ok status, the package name, the start and end dates of the period, and the total download count as an integer. Also includes provenance metadata showing the upstream npm API URL used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "period": {
   "type": "string",
   "description": "period"
  },
  "package": {
   "type": "string",
   "description": "package"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "npm-downloads-point",
  "result": {
   "end": "2026-07-10",
   "start": "2026-06-11",
   "package": "react",
   "downloads": 636394226
  },
  "provenance": {
   "url": "https://api.npmjs.org/downloads/point/last-month/react",
   "source": "npm Download Counts (Point)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-npm-download-counts-point-be2b795f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from npm-downloads-point.hergertsynthora.com](https://www.zero.xyz/host/npm-downloads-point.hergertsynthora.com/llms.txt)