---
title: "GET /v1/search"
method: GET
path: "/v1/search"
tags: ["search"]
---

# GET /v1/search

`GET /v1/search`

## Request

- Base URL: `https://api.pkgseek.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pkgseek.com/v1/search`
- Auth: none declared

## Query parameters

- `q` string
- `distro` string
- `release` string
- `source` string
- `arch` string
- `repo` string
- `catalog_revision` string
- `sort` string
- `limit` integer
- `offset` integer

## Response `200`

Hits, facet counts and total

- SearchResponse: Search payload: one result page, distro facets, total count and conservative package-name corrections when the query appears misspelled.
  - `catalog_revision` string, nullable
  - `facets` SearchFacets, required
    - `distro` object, required: Result count per distro id for the query, ignoring the active filter.
  - `hits` SearchHit[], required
    - `cves` integer, required: Distinct known CVEs across the matched package rows (respects the distro filter).
    - `distros` DistroVersion[], required
      - `arch` string, nullable
      - `id` string, required
      - `release` string, nullable: Release the newest build came from (e.g. `42`, `trixie`). Only populated when the caller needs canonical package links.
      - `repo` string, nullable: Repository/component name for the selected build, when known.
      - `resolution` PackageResolution
        - `catalog_revision` string, required
        - `coverage` ScopeCoverage, required
          - `generation` string, nullable
          - `observed_at` string, nullable
          - `reason` string, required
          - `state` string, required: Legacy index timestamps cannot prove a complete import generation.
        - `match_type` string, required
        - `policy` string, required
        - `requested` PackageScope, required: An explicit ordinary-repository request uses one exact release snapshot.
          - `arch` string, required
          - `distro` string, required
          - `release` string, required
          - `repo` string, nullable
          - `source` string, required
        - `resolved` PackageScope, required: An explicit ordinary-repository request uses one exact release snapshot.
          - `arch` string, required
          - `distro` string, required
          - `release` string, required
          - `repo` string, nullable
          - `source` string, required
        - `selection` string, required
        - `warnings` string[], required
      - `source` string, required: Repository source (`official` for distro-owned repos, otherwise a third-party channel such as `epel` or `remi`).
      - `version` string, required
    - `name` string, required
    - `section` string, nullable
    - `summary` string, required
  - `requested_scope` PackageScope: An explicit ordinary-repository request uses one exact release snapshot.
    - `arch` string, required
    - `distro` string, required
    - `release` string, required
    - `repo` string, nullable
    - `source` string, required
  - `resolution_policy` string, nullable
  - `search_mode` string, nullable
  - `suggestions` string[], required
  - `total` integer, required

---

[API](https://skmtc.dev/pkgseek/apis/pkgseek-api.md) · [All operations](https://skmtc.dev/pkgseek/apis/pkgseek-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pkgseek/apis/pkgseek-api/revisions/277f0f960210?raw)