---
title: "Search prompts"
method: POST
path: "/api/v1/prompts/search"
tags: ["Prompts"]
---

# Search prompts

`POST /api/v1/prompts/search`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/prompts/search`
- Auth: API key in header `x-api-key`

Advanced prompt search with grammar syntax, free-text queries, faceted filtering, and cursor-based pagination. Supports field selectors (`model:midjourney`, `category:landscape`, `ar:16:9`) combined with free-text. Results include signed asset thumbnail URLs.

## Request body

- object
  - `query` string: Search query (supports grammar syntax and free-text)
  - `cursor` string: Pagination cursor from previous response (format: timestamp|hash)
  - `limit` integer
  - `sort` 'updated' | 'created' | 'score' | 'name' | 'most_evaluated'
  - `filters` object
    - `category` string[]
    - `target_model` string[]
    - `tags` string[]
    - `has_variables` boolean
    - `min_score` number
    - `max_score` number

## Response `200`

Search results with pagination cursor

- object
  - `items` object[], required: Matching prompts with signed thumbnail URLs
  - `cursor` string, nullable, required: Cursor for next page (null if no more results)
  - `total_estimate` integer, required: Estimated total matching prompts

## Other responses

- `401`: Unauthorized

---

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