# SYNTHORA npm Download Trend (Daily Range)

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

Returns a per-day download time series for a specified npm package over a given period, enabling trend, momentum, and growth-rate analysis.

## Facts

- Endpoint: POST https://npm-downloads-range.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-trend-daily-range-e8334d0c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KAX5YFX4FJ4HtslXCDs3n

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-trend-daily-range-e8334d0c -d '<json body>'
```

Example prompt: Pull the daily npm download time series for 'express' over the last week so I can see if its download momentum is trending up or down.

## When to prefer this

Choose this endpoint when you need per-day granularity of npm download data for trend detection, momentum scoring, or growth-rate computation — especially in agent pipelines that programmatically evaluate package health or dependency selection. Prefer it over aggregate-only endpoints when the shape of the time series (acceleration, decline, spikes) matters, not just the total count.

## Known failure modes

- Unknown or misspelled package name returns empty or error result
- Invalid period string causes a bad request error
- npm API upstream unavailability causes a fetch failure
- Very new packages with no download history may return zero-count days
- Rate limits on the upstream npm API may cause transient failures

## How this service works

Returns a per-day download time series for an npm package over a period from keyless api.npmjs.org — the raw signal for trend and growth-rate detection. Lets autonomous agents compute momentum/decline and feed agent-to-agent dependency-selection scoring. Ranking surface for trajectory. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

A JSON object containing an array of date/download-count pairs (one entry per day), the total downloads over the period, the package name, and the requested period label, plus provenance metadata pointing back to the underlying npm API URL.

## 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-range",
  "result": {
   "days": [
    {
     "date": "2026-07-04",
     "downloads": 8067032
    },
    {
     "date": "2026-07-05",
     "downloads": 8095754
    },
    {
     "date": "2026-07-06",
     "downloads": 18740552
    },
    {
     "date": "2026-07-07",
     "downloads": 20257125
    },
    {
     "date": "2026-07-08",
     "downloads": 20019677
    },
    {
     "date": "2026-07-09",
     "downloads": 19363203
    },
    {
     "date": "2026-07-10",
     "downloads": 18018843
    }
   ],
   "period": "last-week",
   "package": "express",
   "total_downloads": 112562186
  },
  "provenance": {
   "url": "https://api.npmjs.org/downloads/range/last-week/express",
   "source": "npm Download Trend (Daily Range)"
  }
 }
}
```

## More

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