name: Package Discovery
description: |
Discover PHP Composer packages on Packagist by name, tag, type, or popularity, and
retrieve full package metadata including versions, maintainers, dependencies, and
download counts. Read-only — no authentication required.
api: packagist-api
governance:
classification: read-only
authentication: none
rateLimits:
note: |
Avoid scheduled jobs at the top of the hour or at midnight UTC. Keep concurrent
requests under 10 to packagist.org and under 20 to repo.packagist.org.
operations:
- operationId: searchPackages
intent: Find packages matching a free-text query, tag, or type.
- operationId: listPackages
intent: Enumerate packages owned by a vendor or of a given type.
- operationId: getPopularPackages
intent: Surface the most-installed packages this week.
- operationId: getPackage
intent: Fetch the full application-level package payload (12-hour cache).
- operationId: getPackageMetadataV2
intent: Fetch the Composer v2 static metadata (preferred for resolvers).
- operationId: getPackageMetadataV2Dev
intent: Fetch dev-branch metadata for a package.
inputs:
- name: query
required: false
description: Search term, tag, or vendor scope.
outputs:
- name: packages
description: List of matching packages with name, description, and download stats.
- name: packageDetail
description: Full version graph, dependencies, maintainers, and dist URLs.