API Documentation

Free, open API. No auth required. 200 requests/minute. JSON responses.

Base URL: https://depscope.dev

Auth: None required. Just call it.

Rate Limit: 200 req/min per IP

Format: JSON (UTF-8)

API Endpoints Badges Health Score AI Agents

API Endpoints

GET/api/check/{ecosystem}/{package}

Full package intelligence: health score, vulnerabilities, versions, recommendation.

Parameters

ecosystemstringnpm, pypi, or cargo

packagestringPackage name (supports scoped: @org/pkg)

versionquery stringOptional: specific version to check

curl https://depscope.dev/api/check/npm/express

GET/api/latest/{ecosystem}/{package}

Get latest version only. Ultra-fast, cached response.

Parameters

ecosystemstringnpm, pypi, or cargo

packagestringPackage name

curl https://depscope.dev/api/latest/npm/express

GET/api/exists/{ecosystem}/{package}

Check if a package exists in the registry. Returns true/false.

Parameters

ecosystemstringnpm, pypi, or cargo

packagestringPackage name

curl https://depscope.dev/api/exists/pypi/django

GET/api/health/{ecosystem}/{package}

Quick health score only (0-100).

curl https://depscope.dev/api/health/pypi/fastapi

GET/api/vulns/{ecosystem}/{package}

Known vulnerabilities from OSV database.

curl https://depscope.dev/api/vulns/npm/lodash

GET/api/versions/{ecosystem}/{package}

Version history and latest version info.

curl https://depscope.dev/api/versions/cargo/serde

GET/api/search/{ecosystem}

Search packages by keyword within an ecosystem.

Parameters

ecosystemstringnpm, pypi, or cargo

qquery stringSearch keyword

curl https://depscope.dev/api/search/npm?q=http

GET/api/alternatives/{ecosystem}/{package}

Get recommended alternatives for a package (especially useful for deprecated ones).

Parameters

ecosystemstringnpm, pypi, or cargo

packagestringPackage name

curl https://depscope.dev/api/alternatives/npm/request

GET/api/compare/{ecosystem}/{pkg1},{pkg2},{pkg3}

Compare multiple packages side by side (2-10 packages).

curl https://depscope.dev/api/compare/npm/express,fastify,hono

POST/api/scan

Audit an entire project's dependencies at once (max 100 packages).

curl -X POST https://depscope.dev/api/scan -H "Content-Type: application/json" -d '{"ecosystem":"npm","packages":{"express":"^4.0","lodash":"^4.17"}}'

GET/api/now

Current UTC date/time. Useful for agents to check server time.

curl https://depscope.dev/api/now

GET/api/stats

Public usage statistics and trending packages.

curl https://depscope.dev/api/stats

Badges

Embed health score badges in your README, docs, or website. Returns SVG images with color-coded scores.

GET/badge/{ecosystem}/{package}

Health score badge (SVG). Embed in README or docs. Shows score 0-100 with color coding.

curl:

curl https://depscope.dev/badge/npm/express

Markdown (README):

![DepScope](https://depscope.dev/badge/npm/express)

HTML:

<img src="https://depscope.dev/badge/npm/express" alt="DepScope health score">

GET/badge/score/{ecosystem}/{package}

Score-only badge variant (compact). Same SVG format, minimal style.

curl:

curl https://depscope.dev/badge/score/pypi/django

Markdown (README):

![Score](https://depscope.dev/badge/score/pypi/django)

HTML:

<img src="https://depscope.dev/badge/score/pypi/django" alt="DepScope score">

Badge Colors

80-100

Green

60-79

Yellow

40-59

Orange

0-39

Red

Health Score Breakdown

The health score (0-100) is calculated algorithmically from multiple signals:

Maintenance

Last release date

Security

Known CVEs

Popularity

Weekly downloads

Maturity

Version count

Community

Maintainers

For AI Agents

DepScope is designed to be called by AI agents before they suggest installing any package. The API returns structured JSON that any agent can parse.

ChatGPT / OpenAI Actions:

https://depscope.dev/.well-known/ai-plugin.json

OpenAPI spec:

https://depscope.dev/openapi.json

Interactive docs (Swagger):

https://depscope.dev/docs