API Documentation

Catalog API

Read the same normalized plugin records used by search, categories, creators, and detail pages.

GET/api/pluginsapplication/json

Retrieve the current directory catalog

request.shpublic endpoint

curl -s https://deepseekplugins.org/api/plugins

The application refreshes the public community registry through a short server cache. If the upstream response is unavailable, malformed, or unexpectedly incomplete, the endpoint fails over to the smaller verified local snapshot and reports that state in its response.

Discovery data

Consumers must preserve source and fallback notices. Do not translate a listing into an endorsement, security result, compatibility guarantee, or install-success claim.

SCHEMAcatalog_response.jsonnormalized

Response envelope

example.jsonfields may be null

{
  "plugins": [
    {
      "name": "dsh-example",
      "owner": "github-owner",
      "category": "tools",
      "description": "Example description",
      "install": "dsh plugin --profile web add github:github-owner/dsh-example",
      "npm": null,
      "stars": 0,
      "updatedAt": null,
      "source": "registry"
    }
  ],
  "sourceCount": 249,
  "updated": "2026-08-14",
  "isLive": true,
  "notice": "Live community registry loaded..."
}

pluginsNormalized plugin records accepted by the server validator.

sourceCountUpstream count when supplied; otherwise the accepted record count.

updatedCatalog snapshot date reported by the source or local fallback.

isLivetrue when the upstream registry passed validation for this refresh.

noticeHuman-readable provenance and fallback state for display to users.

NOTESconsumer_contract.mdreview first

Consumer contract and limitations

Key records by the case-insensitive pair owner/name.
Treat optional repository enrichment such as forks, language, license, and timestamps as nullable snapshot data.
Open the repository before installing. The repository remains authoritative for permissions, compatibility, setup, configuration, and removal.
Cache politely. The public endpoint has no uptime, rate-limit, or long-term schema guarantee.
Link back to the plugin detail or source repository when displaying catalog-derived records.

Open live endpoint Sourcing method

Documentation home