From c5619dc695fd169c865aacd5dd15e8e336544ca8 Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Wed, 11 Nov 2026 11:54:38 +0200 Subject: [PATCH] Document rate limiting on the Threat Intelligence npm endpoints The npm and beta endpoints are now limited per API key, per minute, with separate allowances for single lookups, batch and the full feed. The page says how a client sees the limit and what to do on a 429. It leaves the numbers out, like the App API note. --- .../API solutions/Threat Intelligence API/npm-features.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/content/docs/API solutions/Threat Intelligence API/npm-features.md b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md index 6153a71..61f17db 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/npm-features.md +++ b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md @@ -88,6 +88,12 @@ curl 'https://vdp-api.patchstack.com/database/api/npm/all?platform=wordpress&per npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the route separator. URL-encode the `/` as `%2F` or contact us for guidance on the encoding helper. +## Rate limiting + +Requests are limited per API key, per minute. Single lookups (`/product/...`, `/latest`), `/batch` and `/all` each have their own allowance, so a busy batch job doesn't use up your feed sync. `/npm` and the `/beta` alias count against the same allowance. + +Every response carries `X-RateLimit-Limit` and `X-RateLimit-Remaining`. Past the limit you get `429 Too Many Requests` with a `Retry-After` header: wait that many seconds, then retry. The `error` field of the response names the limit you hit. + ## Errors In addition to the [stable error codes](/api-solutions/threat-intelligence-api/extended/#errors), the npm endpoints return: