---
title: "Execute an App tab search"
method: POST
path: "/v1/public/apps/{slug}/search"
tags: ["Public Apps API"]
---

# Execute an App tab search

`POST /v1/public/apps/{slug}/search`

## Request

- Base URL: `https://api.mixpeek.com`
- URL: `https://api.mixpeek.com/v1/public/apps/{slug}/search`
- Auth: none required

Execute a search on a specific tab of a public App — no authentication required.

Routes `tab_id` → retriever → results. Each tab can be backed by either:
- An **internal retriever** (`retriever_id`) — org-scoped
- A **marketplace catalog entry** (`public_name`) — proxied via public API

The `inputs` dict is passed directly to the retriever's `input_schema`.
Extra top-level fields are automatically merged into `inputs`.

**Example:**
```json
{
  "tab_id": "search",
  "inputs": { "query": "red sneakers" },
  "settings": { "limit": 20 }
}
```

## Path parameters

- `slug` string, required: Globally unique app slug

## Request body

- PublicAppSearchRequest: Request to execute a search on a specific tab of an App. Extra top-level fields are merged into ``inputs`` automatically so callers can pass retriever inputs without extra nesting.
  - `tab_id` string, required: Tab ID to search within
  - `inputs` object
  - `settings` object

## Response `200`

Search results from the tab's retriever

- unknown

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `success` to the response with the `422` status
  - …2 more

[Operation history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/public/apps/:slug/search/post.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) - [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixpeek/apis/mixpeek-api/revisions/790bc16455f6?raw)