---
title: "Typesense-ranked search over APPROVED plugins (falls back to SQL)"
method: GET
path: "/v1/plugins/search"
tags: ["Public Plugins"]
---

# Typesense-ranked search over APPROVED plugins (falls back to SQL)

`GET /v1/plugins/search`

## Query parameters

- `page` number
- `pageSize` number
- `q` string, required
- `category` string
- `partnerId` string, uuid

## Response `200`

- PagedPluginPublicDto
  - `items` PluginPublicDto[], required
    - `id` string, uuid, required
    - `packageName` string, required
    - `slug` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `registry` string, required
    - `repositoryUrl` string, nullable, required
    - `iconUrl` string, nullable, required
    - `downloadCount` number, required
    - `latestVersion` string, nullable, required
    - `lastPublish` string, date-time, nullable, required
    - `compatibility` string, nullable, required
    - `readme` string, nullable, required — Markdown readme
    - `changelog` string, nullable, required — Markdown changelog
    - `docs` string, nullable, required — Markdown docs
    - `metadataVersion` string, nullable, required — The npm version the markdown was sourced from. `null` when the package has not yet been synced from npm.
    - `partnerId` string, uuid, nullable, required
    - `categories` string[], required — Category codes
    - `createdAt` string, date-time, required
  - `total` number, required — Total number of items matching the query
  - `page` number, required — Current page (1-based)
  - `pageSize` number, required — Items per page

## Other responses

- `400` — Validation failed
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `500` — Internal server error

---

[API](https://skmtc.net/vendure/apis/vendure-io-api-public.md) · [All operations](https://skmtc.net/vendure/apis/vendure-io-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vendure/vendure-io-api-public/revisions/5fc4757128af/schema)