{"openapi":"3.0.3","info":{"title":"Package Registries API (ReefAPI)","version":"1.0.0","description":"Package Registries API — npm (Node.js) and PyPI (Python) metadata, version history, dependencies, download counts and keyword search (no API key required) Call POST /packages/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/packages-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"Package Registries API documentation","url":"https://reefapi.com/docs/packages"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"packages","description":"Package Registries API — npm (Node.js) and PyPI (Python) metadata, version history, dependencies, download counts and keyword search (no API key required)"}],"paths":{"/packages/v1/package":{"post":{"operationId":"packages_package","summary":"full package metadata (latest version normalized)","description":"full package metadata (latest version normalized)","tags":["packages"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string","enum":["npm","pypi","node","nodejs","python","pip"],"example":"npm","description":"Which package registry to query. npm = Node.js packages; pypi = Python packages. (Synonyms node/nodejs -> npm, python/pip -> pypi.)"},"name":{"type":"string","example":"react","description":"Exact package name (e.g. npm 'react', PyPI 'requests'). Scoped npm names like '@scope/pkg' are supported."}},"required":["registry","name"]},"example":{"registry":"npm","name":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/packages/v1/versions":{"post":{"operationId":"packages_versions","summary":"paginated version list for a package","description":"paginated version list for a package","tags":["packages"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string","enum":["npm","pypi","node","nodejs","python","pip"],"example":"npm","description":"Which package registry to query. npm = Node.js packages; pypi = Python packages. (Synonyms node/nodejs -> npm, python/pip -> pypi.)"},"name":{"type":"string","example":"react","description":"Exact package name (e.g. npm 'react', PyPI 'requests'). Scoped npm names like '@scope/pkg' are supported."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number for paginated lists (versions / search)."},"page_size":{"type":"integer","minimum":1,"maximum":250,"default":50,"example":50,"description":"Results per page (1-250, default 50). Larger values are clamped."}},"required":["registry","name"]},"example":{"registry":"npm","name":"react","page_size":10}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/packages/v1/version":{"post":{"operationId":"packages_version","summary":"single version metadata","description":"single version metadata","tags":["packages"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string","enum":["npm","pypi","node","nodejs","python","pip"],"example":"npm","description":"Which package registry to query. npm = Node.js packages; pypi = Python packages. (Synonyms node/nodejs -> npm, python/pip -> pypi.)"},"name":{"type":"string","example":"react","description":"Exact package name (e.g. npm 'react', PyPI 'requests'). Scoped npm names like '@scope/pkg' are supported."},"version":{"type":"string","example":"18.2.0","description":"Exact version string to fetch (e.g. '18.2.0', '2.31.0')."}},"required":["registry","name","version"]},"example":{"registry":"pypi","name":"requests","version":"2.34.2"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/packages/v1/dependencies":{"post":{"operationId":"packages_dependencies","summary":"runtime + dev dependencies for a version (latest if omitted)","description":"runtime + dev dependencies for a version (latest if omitted)","tags":["packages"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string","enum":["npm","pypi","node","nodejs","python","pip"],"example":"npm","description":"Which package registry to query. npm = Node.js packages; pypi = Python packages. (Synonyms node/nodejs -> npm, python/pip -> pypi.)"},"name":{"type":"string","example":"react","description":"Exact package name (e.g. npm 'react', PyPI 'requests'). Scoped npm names like '@scope/pkg' are supported."},"version":{"type":"string","example":"18.2.0","description":"Optional exact version; omit to use the latest published version."}},"required":["registry","name"]},"example":{"registry":"npm","name":"react"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/packages/v1/downloads":{"post":{"operationId":"packages_downloads","summary":"download statistics (npm: period=last-day|week|month|year; pypi: recent day/week/month)","description":"download statistics (npm: period=last-day|week|month|year; pypi: recent day/week/month)","tags":["packages"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string","enum":["npm","pypi","node","nodejs","python","pip"],"example":"npm","description":"Which package registry to query. npm = Node.js packages; pypi = Python packages. (Synonyms node/nodejs -> npm, python/pip -> pypi.)"},"name":{"type":"string","example":"react","description":"Exact package name (e.g. npm 'react', PyPI 'requests'). Scoped npm names like '@scope/pkg' are supported."},"period":{"type":"string","enum":["last-day","last-week","last-month","last-year"],"default":"last-month","example":"last-month","description":"npm download window (rejects unknown values). Ignored for PyPI, which always returns recent last-day/last-week/last-month totals."}},"required":["registry","name"]},"example":{"registry":"npm","name":"react","period":"last-month"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/packages/v1/search":{"post":{"operationId":"packages_search","summary":"search packages (npm: registry API; pypi: libraries.io→HTML→ranked simple-index+enrich)","description":"search packages (npm: registry API; pypi: libraries.io→HTML→ranked simple-index+enrich)","tags":["packages"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string","enum":["npm","pypi","node","nodejs","python","pip"],"example":"npm","description":"Which package registry to query. npm = Node.js packages; pypi = Python packages. (Synonyms node/nodejs -> npm, python/pip -> pypi.)"},"query":{"type":"string","example":"http client","description":"Free-text search keywords matched against package name/description."},"page":{"type":"integer","minimum":1,"default":1,"example":1,"description":"1-based page number for paginated lists (versions / search)."},"page_size":{"type":"integer","minimum":1,"maximum":250,"default":20,"example":20,"description":"Results per page (1-250, default 20). Larger values are clamped."},"from":{"type":"integer","minimum":0,"example":0,"description":"npm search only: raw result offset (alternative to page). Page forward with meta.next_from."}},"required":["registry","query"]},"example":{"registry":"npm","query":"fastapi"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/packages/v1/maintainer":{"post":{"operationId":"packages_maintainer","summary":"maintainer/author records for a package","description":"maintainer/author records for a package","tags":["packages"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"string","enum":["npm","pypi","node","nodejs","python","pip"],"example":"npm","description":"Which package registry to query. npm = Node.js packages; pypi = Python packages. (Synonyms node/nodejs -> npm, python/pip -> pypi.)"},"name":{"type":"string","example":"react","description":"Exact package name (e.g. npm 'react', PyPI 'requests'). Scoped npm names like '@scope/pkg' are supported."}},"required":["registry","name"]},"example":{"registry":"pypi","name":"requests"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}