---
title: "GET /api/marketplace/apps/search"
method: GET
path: "/api/marketplace/apps/search"
tags: ["Marketplace"]
---

# GET /api/marketplace/apps/search

`GET /api/marketplace/apps/search`

## Query parameters

- `category` 'ai' | 'automation' | 'books' | 'data' | 'development' | 'featured' | 'finance' | 'gaming' | 'media' | 'music' | 'network' | 'photography' | 'security' | 'social' | 'utilities'
- `cursor` string
- `pageSize` string
- `search` string
- `storeId` string

## Response `default`

- SearchAppsDto
  - `data` object[], required
    - `available` boolean, required
    - `categories` string[], required
    - `created_at` integer, required
    - `deprecated` boolean, required
    - `id` string, required
    - `name` string, required
    - `short_desc` string, required
    - `supported_architectures` string[], required
    - `urn` string, required
  - `total` number, required
  - `nextCursor` string, nullable

## Changes

- **2025-10-15** `3ae3fddfdadb` — 1 info
  - the response property `data/items/supported_architectures` became required for the status `default`
- **2025-09-20** `b18f9d8a574e` — 1 breaking
  - response property `nextCursor` list-of-types was widened by adding types `null` to media type `application/json` of response `default`
- **2025-09-19** `04aac8a043a6` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - for the `query` request parameter `pageSize`, the type was generalized from `number` to `string`
- **2025-05-09** `0db10235cd0a` — 1 breaking, 1 info
  - for the `query` request parameter `pageSize`, the type changed from `string` to `number`
  - added the success response with the status `200`

[Change history](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/marketplace/apps/search/get.md)

---

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