# PyPI (/docs/pypi) Read one release of a PyPI project with its dependencies, supported Python versions and every file's sha256 digest PyPI is the package index for Python. This endpoint reads one release of a project, the latest by default. It uses the canonical `Post` shape: the project name is `post.id` and `post.ext.title`, the summary is `post.content.text`, the long description is `post.ext.description`, and the PyPI-only facts sit in `post.ext.pypi`. Base URL: `/v1/pypi/...` PyPI exposes 1 routes here. ## Quickstart ### Read a project release Pass the name as `project` and, optionally, a `version`. Or pass the project's PyPI page as `url`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/pypi/project?project=requests&version=2.31.0" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "post": { "id": "requests", "url": "https://pypi.org/project/requests/2.31.0/", "content": { "text": "Python HTTP for Humans." }, "ext": { "title": "requests", "pypi": { "version": "2.31.0", "requires_python": ">=3.7", "requires_dist": ["charset-normalizer (<4,>=2)", "idna (<4,>=2.5)"], "files": [ { "filename": "requests-2.31.0-py3-none-any.whl", "sha256": "58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f", "package_type": "bdist_wheel" } ] } } } } } ``` ## Questions people ask ### Can I verify the files I download? Yes. Every file in `post.ext.pypi.files` carries its `sha256` digest, size and download link. ### What are the dependencies? `post.ext.pypi.requires_dist` lists them as the project declares them, with version ranges, extras and environment markers. ### Do I get the author's email address? No. Author and maintainer email addresses are not returned. ### What does a project or version that does not exist return? A `404`, which is not charged. ## All endpoints ## Platform notes **The latest release is the default.** Pass `version` to read an older release; `post.url` then links that release's page. **Yanked releases are marked.** `post.ext.pypi.yanked` is true on a release its maintainers withdrew, and each file carries its own `yanked` flag. ## Next steps - [npm](/docs/npm.md): JavaScript packages in the same Post shape. - [GitHub](/docs/github.md): The repositories behind the packages.