Sign in

v5

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-167122208.0 KB
packages

search

Pass pagination information using the following headers listed here:

Example request:

curl "https://packagecloud.io/api/v1/repos/test_user/test_repo/search?q="
get/api/v1/repos/{user_id}/{repo}/search.json

Path parameters

user_idstring required
repostring required

Query parameters

archstring

The architecture of the packages. (i.e. x86_64, arm64, amd64) - Alpine/RPM/Debian only.

diststring

The name of the distribution the package is in. (i.e. ubuntu, el/6) - Overrides [:filter]

filterstring

Search by package type (RPMs, Debs, DSCs, Gem, Python, Node) - Ignored when [:dist] is present.

pageinteger

One-based page index.

per_pagestring

The number of packages to return from the results set. If nothing passed, default is 30

qstring

The query string to search for package filename. If empty string is passed, all packages are returned

Response

PackageFragment A JSON array of PackageFragment objects hat match the query parameters.

namestring required

The name of the package.

created_atstring required

When the package was uploaded.

distro_versionstring required

The distro_version for the package.

versionstring required

The version of the package.

releasestring nullable

The release of the package (if available).

architecturestring nullable

The architecture of the package (if available).

epochinteger nullable

The epoch of the package (if available).

scopestring nullable

The scope of the package (if available).

privateboolean required

Whether or not the package is in a private repository.

typestring required

The type of package ("deb", "gem", or "rpm").

filenamestring required

The filename of the package.

uploader_namestring required

The name of the uploader for the package.

indexedboolean required

Whether or not this package has been indexed.

repository_html_urlstring required

The HTML url of the repository.

package_urlstring required

The API url for this package.

package_html_urlstring required

The HTML url for this package.

downloads_detail_urlstring required

The url to get access log details for package downloads.

downloads_series_urlstring required

The url to get time series data for package downloads.

downloads_count_urlstring required

The url to get the total number of package downloads.

promote_urlstring required

The url for promoting this to another repository.

destroy_urlstring required

The url for the HTTP DELETE request to destroy this package.

download_urlstring required

The direct download URL for this package (includes a read token).

sha256sumstring nullable

The SHA-256 checksum of the package file.

Example response

[
  {
    "name": "jake",
    "distro_version": "fedora/22",
    "created_at": "2017-03-13T02:49:29.000Z",
    "version": "1.0",
    "release": "1.el6",
    "epoch": 0,
    "scope": null,
    "private": false,
    "type": "rpm",
    "filename": "jake-1.0-1.el6.x86_64.rpm",
    "uploader_name": "test_user",
    "indexed": false,
    "repository_html_url": "/test_user/test_repo",
    "package_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6.json",
    "downloads_detail_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/detail.json",
    "downloads_series_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/series/daily.json",
    "downloads_count_url": "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/count.json",
    "package_html_url": "/test_user/test_repo/packages/fedora/22/jake-1.0-1.el6.x86_64.rpm",
    "promote_url": "/api/v1/repos/test_user/test_repo/fedora/22/jake-1.0-1.el6.x86_64.rpm/promote.json",
    "delete_url": "/api/v1/repos/test_user/test_repo/fedora/22/jake-1.0-1.el6.x86_64.rpm"
  }
]