Package Sus Detector: npm & PyPI package risk check API

Check a package before you install it. Give Package Sus Detector a list of npm or PyPI packages (or paste a package.json / requirements.txt, or upload a

Input

Send these Fields as input. A Field not listed here is refused.

packages

Packages to check (one per line; npm: or pypi: prefix to mix; name@1.2.3 or name==1.2.3)

  • Type: string
  • Required: no
  • Length in characters: at most 30000

ecosystem

Default ecosystem (for lines without npm: / pypi:)

  • Type: string
  • Required: no
  • Allowed values: npm, pypi

packageJson

package.json contents (optional)

  • Type: string
  • Required: no
  • Length in characters: at most 30000

requirementsTxt

requirements.txt contents (optional)

  • Type: string
  • Required: no
  • Length in characters: at most 30000

lockfile

Lockfile (optional): package-lock.json, npm-shrinkwrap.json, yarn.lock, pnpm-lock.yaml, poetry.lock, uv.lock or Pipfile.lock

An https URL or an upload id.

  • Type: string
  • Required: no

baseLockfile

Base lockfile to diff against (optional): only new or changed packages are checked

An https URL or an upload id.

  • Type: string
  • Required: no

includeDevDependencies

Include devDependencies (package.json, package-lock.json, Pipfile.lock)

  • Type: string
  • Required: no
  • Allowed values: yes, no

projectLicenseType

Your project's licence type (unspecified, permissive, proprietary, weak-copyleft, strong-copyleft)

  • Type: string
  • Required: no
  • Allowed values: unspecified, permissive, proprietary, weak-copyleft, strong-copyleft

maxPackages

Max packages per run

  • Type: number
  • Required: no
  • Value: 1 to 5000

failOn

CI gate: fail on (never = report only)

  • Type: string
  • Required: no
  • Allowed values: never, caution, suspicious, not_found

failOnRiskScore

CI gate: fail at risk score (optional, 1-100)

  • Type: number
  • Required: no
  • Value: 1 to 100

newPackageDays

'New package' threshold (days)

  • Type: number
  • Required: no
  • Value: 1 to 365

staleDays

'Stale' threshold (days); twice this is 'abandoned'

  • Type: number
  • Required: no
  • Value: 90 to 3650

includeDownloads

Look up download counts (api.npmjs.org / pypistats.org)

  • Type: string
  • Required: no
  • Allowed values: yes, no

includeVulnerabilities

Look up known vulnerabilities (OSV)

  • Type: string
  • Required: no
  • Allowed values: yes, no

includeDepsDev

Include deps.dev data

  • Type: string
  • Required: no
  • Allowed values: yes, no

includeEol

Check end-of-life status (endoflife.date)

  • Type: string
  • Required: no
  • Allowed values: yes, no

includeScorecard

Include OpenSSF Scorecard summary (one extra request per package)

  • Type: string
  • Required: no
  • Allowed values: yes, no

includeSummaryItem

Add the summary as the last item of results.json

  • Type: string
  • Required: no
  • Allowed values: yes, no

concurrency

Concurrency (packages checked in parallel)

  • Type: number
  • Required: no
  • Value: 1 to 16

Run it

One call presses the Widget and answers the run once its status is succeeded or failed, however long it takes. The key is read from ABYSS_API_KEY. Install the library with npm install abysshub or pip install abysshub; cURL sends the Fields as a form.

JavaScript

// index.mjs
import Abyss from "abysshub";

const abyss = new Abyss();

const run = await abyss.run("widget_382", {
  packages: "npm:react\nnpm:lodash@4.17.15\npypi:requests\npypi:django==2.2.0\nnpm:express-ai-validator-helper-pro\npypi:flask-super-auth-helper",
  ecosystem: "npm",
  includeDevDependencies: "yes",
  projectLicenseType: "unspecified",
  maxPackages: 500,
  failOn: "never",
  failOnRiskScore: 100,
  newPackageDays: 30,
  staleDays: 730,
  includeDownloads: "yes",
  includeVulnerabilities: "yes",
  includeDepsDev: "yes",
  includeEol: "yes",
  includeScorecard: "no",
  includeSummaryItem: "yes",
  concurrency: 8,
});

console.log(run.result);
for (const path of await run.save("output")) {
  console.log(path);
}

Python

from abysshub import Abyss

abyss = Abyss()

run = abyss.run("widget_382", {
    "packages": "npm:react\nnpm:lodash@4.17.15\npypi:requests\npypi:django==2.2.0\nnpm:express-ai-validator-helper-pro\npypi:flask-super-auth-helper",
    "ecosystem": "npm",
    "includeDevDependencies": "yes",
    "projectLicenseType": "unspecified",
    "maxPackages": 500,
    "failOn": "never",
    "failOnRiskScore": 100,
    "newPackageDays": 30,
    "staleDays": 730,
    "includeDownloads": "yes",
    "includeVulnerabilities": "yes",
    "includeDepsDev": "yes",
    "includeEol": "yes",
    "includeScorecard": "no",
    "includeSummaryItem": "yes",
    "concurrency": 8,
})

print(run.result)
for path in run.save("output"):
    print(path)

cURL

curl https://api.abysshub.com/v1/widgets/widget_382/runs \
  -H "Authorization: Bearer $ABYSS_API_KEY" \
  -F 'packages=npm:react
npm:lodash@4.17.15
pypi:requests
pypi:django==2.2.0
npm:express-ai-validator-helper-pro
pypi:flask-super-auth-helper' \
  -F ecosystem=npm \
  -F includeDevDependencies=yes \
  -F projectLicenseType=unspecified \
  -F maxPackages=500 \
  -F failOn=never \
  -F failOnRiskScore=100 \
  -F newPackageDays=30 \
  -F staleDays=730 \
  -F includeDownloads=yes \
  -F includeVulnerabilities=yes \
  -F includeDepsDev=yes \
  -F includeEol=yes \
  -F includeScorecard=no \
  -F includeSummaryItem=yes \
  -F concurrency=8

A succeeded run carries its result and its output_files. Their URLs are signed for each read: re-read the run, never store a URL. A run still queued or running in the answer (after an hour, or when the API is busy) is read again at its Location with ?wait=true.

What it answers

The Example Run's result, the JSON the Widget wrote to output/output.json:

{
  "summary": {
    "recordType": "summary",
    "totalChecked": 6,
    "verdictCounts": {
      "ok": 2,
      "caution": 2,
      "suspicious": 0,
      "not_found": 2,
      "error": 0
    },
    "overall": "not_found",
    "averageRiskScore": 37,
    "packagesWithKnownVulnerabilities": 2,
    "totalKnownVulnerabilities": 48,
    "knownMaliciousListed": [],
    "worstOffenders": [
      {
        "ecosystem": "npm",
        "name": "express-ai-validator-helper-pro",
        "version": null,
        "verdict": "not_found",
        "riskScore": 75,
        "topReasons": [
          "not_in_registry",
          "plausible_hallucinated_name"
        ]
      },
      {
        "ecosystem": "pypi",
        "name": "flask-super-auth-helper",
        "version": null,
        "verdict": "not_found",
        "riskScore": 75,
        "topReasons": [
          "not_in_registry",
          "plausible_hallucinated_name"
        ]
      },
      {
        "ecosystem": "pypi",
        "name": "django",
        "version": "2.2",
        "verdict": "caution",
        "riskScore": 47,
        "topReasons": [
          "known_vulnerabilities_critical",
          "release_line_end_of_life"
        ]
      },
      {
        "ecosystem": "npm",
        "name": "lodash",
        "version": "4.17.15",
        "verdict": "caution",
        "riskScore": 24,
        "topReasons": [
          "known_vulnerabilities_high"
        ]
      },
      {
        "ecosystem": "npm",
        "name": "react",
        "version": "19.3.1",
        "verdict": "ok",
        "riskScore": 0,
        "topReasons": []
      }
    ],
    "chargedPackages": 6,
    "notes": [],
    "stoppedEarly": false,
    "startedAt": "2026-11-18T22:38:03.550Z",
    "finishedAt": "2026-11-18T22:38:04.814Z",
    "durationSeconds": 1.3,
    "httpRequests": 25,
    "popularListsGeneratedAt": {
      "npm": "2026-10-26T05:10:04.551Z",
      "pypi": "2026-10-26T05:10:04.551Z"
    },
    "disclaimer": "Risk signals only, derived from public registry metadata and advisory databases. A signal is not proof of wrongdoing; verify before acting.",
    "gate": {
      "failOn": "never",
      "failOnRiskScore": 100,
      "enabled": true,
      "passed": true,
      "exitCode": 0,
      "failingCount": 0,
      "failing": [],
      "incomplete": 0,
      "complete": true,
      "notChecked": 0
    },
    "markdown": "### Package Sus Detector: PASSED\n6 package(s) checked: 2 ok, 2 caution, 0 suspicious, 2 not found.\nGate: fail on risk score >= 100.\n\n| Package | Verdict | Score | Why |\n| --- | --- | --- | --- |\n| `express-ai-validator-helper-pro` (npm) | not_found | 75 | Not found in the public registry. Treat as a possibly hallucinated or removed package name. |\n| `flask-super-auth-helper` (pypi) | not_found | 75 | Not found in the public registry. Treat as a possibly hallucinated or removed package name. |\n| `django@2.2` (pypi) | caution | 47 | 43 known vulnerabilities affect 2.2 (max severity: critical; fix available in 6.1.1). Release line 2.2 reached end-of-life on 2022-04-11 (endoflife.date). |\n| `lodash@4.17.15` (npm) | caution | 24 | 5 known vulnerabilities affect 4.17.15 (max severity: high; fix available in 4.18.0). |\n\n_Risk signals from public registry and advisory data, not accusations or a guarantee of safety._"
  },
  "items": [
    {
      "recordType": "package",
      "ecosystem": "npm",
      "name": "react",
      "requestedVersion": null,
      "requestedRange": null,
      "verdict": "ok",
      "riskScore": 0,
      "resolvedVersion": "19.3.1",
      "summary": "No notable risk signals found.",
      "reasons": [],
      "registry": {
        "exists": true,
        "url": "https://www.npmjs.com/package/react",
        "description": "React is a JavaScript library for building user interfaces.",
        "firstPublishedAt": "2011-10-26T17:46:22Z",
        "ageDays": 5502,
        "latestVersion": "19.3.1",
        "latestReleaseAt": "2026-10-14T16:47:15Z",
…

More

Keys, files, errors and limits: API access.