Text of docs.pypi.org › api › json as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

JSON API - PyPI User Documentation

Skip to content JSON API ¶ Tip This page documents the PyPI-specific JSON API. If all you need is a JSON index API (e.g. for retrieving) all distributions or all versions for a package, you can use the Index API . Routes ¶ Get a project ¶ Route: GET /pypi/<project>/json Returns metadata (info) about an individual project at the latest version, a list of all releases for that project, and project URLs. Releases include the release name, URL, and hash digests for MD5, SHA256, and BLAKE2b-256, and are keyed by the release version string.

Metadata returned comes from the values provided at upload time and does not necessarily match the content of the uploaded files. The first uploaded data for a release is stored, subsequent uploads do not update it. Each file object also includes a core-metadata key describing the Core Metadata served alongside the distribution (see PEP 658 and PEP 714 ). Its value is false when no metadata file is available, or an object of hash digests (e.g. {"sha256": "..."} ) when it is.

This mirrors the core-metadata key already exposed by the Index API and lets mirrors discover and serve Core Metadata without an additional request. On this endpoint, the vulnerabilities array provides a listing for any known vulnerabilities in the most recent release (none, for the example above). Use the release-specific endpoint documented below for precise control over this field. Deprecated keys The following keys are considered deprecated: releases : projects should shift to using the Index API to get this information, where possible. downloads : this key is always -1 and should not be used. has_sig : this key is always false and should not be used. bugtrack_url : this key is always null and should not be used.

In the future, each of these keys may be removed entirely from this API response. Status codes: 200 OK - no error Example request: GET /pypi/sampleproject/json HTTP / 1.1 Host : pypi.org Accept : application/json Example JSON response HTTP / 1.1 200 OK Content-Type : application/json; charset="UTF-8" { "info" : { "author" : "" , "author_email" : "\"A. Random Developer\" <author@example.com>" , "bugtrack_url" : null , "classifiers" : [ "Development Status :: 3 - Alpha" , "Intended Audience :: Developers" , "License :: OSI Approved :: MIT License" , "Programming Language :: Python :: 3" , "Programming Language :: Python :: 3 :: Only" , "Programming Language :: Python :: 3.10" , "Programming Language :: Python :: 3.11" , "Programming Language :: Python :: 3.12" , "Programming Language :: Python :: 3.13" , "Programming Language :: Python :: 3.9" , "Topic :: Software Development :: Build Tools" ], "description" : "..." , "description_content_type" : "text/markdown" , "docs_url" : null , "download_url" : "" , "downloads" : { "last_day" : -1 , "last_month" : -1 , "last_week" : -1 }, "dynamic" : [ "requires_dist" ], "home_page" : "" , "keywords" : "sample, setuptools, development" , "license" : "..." , "license_expression" : null , "license_files" : null , "maintainer" : "" , "maintainer_email" : "\"A.

Great Maintainer\" <maintainer@example.com>" , "name" : "sampleproject" , "package_url" : "https://pypi.org/project/sampleproject/" , "platform" : null , "project_url" : "https://pypi.org/project/sampleproject/" , "project_urls" : { "Bug Reports" : "https://github.com/pypa/sampleproject/issues" , "Funding" : "https://donate.pypi.org" , "Homepage" : "https://github.com/pypa/sampleproject" , "Say Thanks!" : "http://saythanks.io/to/example" , "Source" : "https://github.com/pypa/sampleproject/" }, "provides_extra" : [ "dev" , "test" ], "release_url" : "https://pypi.org/project/sampleproject/4.0.0/" , "requires_dist" : [ "peppercorn" , "check-manifest ; extra == 'dev'" , "coverage ; extra == 'test'" ], "requires_python" : ">=3.9" , "summary" : "A sample Python project" , "version" : "4.0.0" , "yanked" : false , "yanked_reason" : null }, "last_serial" : 25862117 , "releases" : { "1.0" : [], "1.2.0" : [ { "comment_text" : "" , "core-metadata" : false , "digests" : { "blake2b_256" : "3052547eb3719d0e872bdd6fe3ab60cef92596f95262e925e1943f68f840df88" , "md5" : "bab8eb22e6710eddae3c6c7ac3453bd9" , "sha256" : "7a7a8b91086deccc54cac8d631e33f6a0e232ce5775c6be3dc44f86c2154019d" }, "downloads" : -1 , "filename" : "sampleproject-1.2.0-py2.py3-none-any.whl" , "has_sig" : false , "md5_digest" : "bab8eb22e6710eddae3c6c7ac3453bd9" , "packagetype" : "bdist_wheel" , "python_version" : "2.7" , "requires_python" : null , "size" : 3795 , "upload_time" : "2015-06-14T14:38:05" , "upload_time_iso_8601" : "2015-06-14T14:38:05.875222Z" , "url" : "https://files.pythonhosted.org/packages/30/52/547eb3719d0e872bdd6fe3ab60cef92596f95262e925e1943f68f840df88/sampleproject-1.2.0-py2.py3-none-any.whl" , "yanked" : false , "yanked_reason" : null }, { "comment_text" : "" , "core-metadata" : false , "digests" : { "blake2b_256" : "eb4579be82bdeafcecb9dca474cad4003e32ef8e4a0dec6abbd4145ccb02abe1" , "md5" : "d3bd605f932b3fb6e91f49be2d6f9479" , "sha256" : "3427a8a5dd0c1e176da48a44efb410875b3973bd9843403a0997e4187c408dc1" }, "downloads" : -1 , "filename" : "sampleproject-1.2.0.tar.gz" , "has_sig" : false , "md5_digest" : "d3bd605f932b3fb6e91f49be2d6f9479" , "packagetype" : "sdist" , "python_version" : "source" , "requires_python" : null , "size" : 3148 , "upload_time" : "2015-06-14T14:37:56" , "upload_time_iso_8601" : "2015-06-14T14:37:56.383366Z" , "url" : "https://files.pythonhosted.org/packages/eb/45/79be82bdeafcecb9dca474cad4003e32ef8e4a0dec6abbd4145ccb02abe1/sampleproject-1.2.0.tar.gz" , "yanked" : false , "yanked_reason" : null } ], "1.3.0" : [ "..." ], "1.3.1" : [ "..." ], "2.0.0" : [ "..." ], "3.0.0" : [ "..." ], "4.0.0" : [ { "comment_text" : "" , "core-metadata" : { "sha256" : "a1d0c6e83f027327d8461063f4ac58a6e4a7a5d0a0e0d5b6c3b2e1f0a9b8c7d6" }, "digests" : { "blake2b_256" : "d773c16e5f3f0d37c60947e70865c255a58dc408780a6474de0523afd0ec553a" , "md5" : "d3857a217dacbca9e40a85f06f2b34f1" , "sha256" : "c23e447ea90d796d1e645c35c4b2de125040add12a845825546f91c93f391b6b" }, "downloads" : -1 , "filename" : "sampleproject-4.0.0-py3-none-any.whl" , "has_sig" : false , "md5_digest" : "d3857a217dacbca9e40a85f06f2b34f1" , "packagetype" : "bdist_wheel" , "python_version" : "py3" , "requires_python" : ">=3.9" , "size" : 4661 , "upload_time" : "2024-11-06T22:37:09" , "upload_time_iso_8601" : "2024-11-06T22:37:09.220617Z" , "url" : "https://files.pythonhosted.org/packages/d7/73/c16e5f3f0d37c60947e70865c255a58dc408780a6474de0523afd0ec553a/sampleproject-4.0.0-py3-none-any.whl" , "yanked" : false , "yanked_reason" : null }, { "comment_text" : "" , "core-metadata" : { "sha256" : "b2e1d7f94a138438e9572174a5bd69b7f5b8b6e1b1f1e6c7d4c3f2a1b0c9d8e7" }, "digests" : { "blake2b_256" : "488cc18d25735962870ccb6d1cd2ac7bde40008a332211055e260cb7ec4c6bab" , "md5" : "9eab89661feaaf3b05b60fb1ed1f7171" , "sha256" : "0ace7980f82c5815ede4cd7bf9f6693684cec2ae47b9b7ade9add533b8627c6b" }, "downloads" : -1 , "filename" : "sampleproject-4.0.0.tar.gz" , "has_sig" : false , "md5_digest" : "9eab89661feaaf3b05b60fb1ed1f7171" , "packagetype" : "sdist" , "python_version" : "source" , "requires_python" : ">=3.9" , "size" : 5760 , "upload_time" : "2024-11-06T22:37:10" , "upload_time_iso_8601" : "2024-11-06T22:37:10.868088Z" , "url" : "https://files.pythonhosted.org/packages/48/8c/c18d25735962870ccb6d1cd2ac7bde40008a332211055e260cb7ec4c6bab/sampleproject-4.0.0.tar.gz" , "yanked" : false , "yanked_reason" : null } ] }, "urls" : [ { "comment_text" : "" , "core-metadata" : { "sha256" : "a1d0c6e83f027327d8461063f4ac58a6e4a7a5d0a0e0d5b6c3b2e1f0a9b8c7d6" }, "digests" : { "blake2b_256" : "d773c16e5f3f0d37c60947e70865c255a58dc408780a6474de0523afd0ec553a" , "md5" : "d3857a217dacbca9e40a85f06f2b34f1" , "sha256" : "c23e447ea90d796d1e645c35c4b2de125040add12a845825546f91c93f391b6b" }, "downloads" : -1 , "filename" : "sampleproject-4.0.0-py3-none-any.whl" , "has_sig" : false , "md5_digest" : "d3857a217dacbca9e40a85f06f2b34f1" , "packagetype" : "

The rest of this page is on the live site.