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.