SocialCrawl

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.

cURL
curl "https://www.socialcrawl.dev/v1/pypi/project?project=requests&version=2.31.0" \
  -H "x-api-key: YOUR_API_KEY"
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

1 endpoint available.

EndpointPathCredit Tier
Get a PyPI project release/v1/pypi/projectstandard (1cr)

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