---
title: "Semantic search for similar posts"
method: GET
path: "/posts/similar"
---

# Semantic search for similar posts

`GET /posts/similar`

## Request

- Base URL: `https://app.voteship.app/api/v1`
- URL: `https://app.voteship.app/api/v1/posts/similar`
- Auth: HTTP bearer

Search for posts semantically similar to the given query text using pgvector embeddings.

## Query parameters

- `query` string, required
- `threshold` number
- `limit` integer

## Response `200`

Similar posts ranked by similarity

- object
  - `data` object[]
    - `id` string
    - `title` string
    - `similarity` number
    - `voteCount` integer
    - `status` string

---

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