---
title: "Search completed surveys"
method: POST
path: "/semantic-search/search"
tags: ["Semantic Search"]
---

# Search completed surveys

`POST /semantic-search/search`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/semantic-search/search`
- Auth: HTTP bearer

Searches completed surveys in your enrolled team account using vector semantic retrieval. The team is resolved from the Bearer token.

## Request body

- object
  - `query` string, required: Natural-language search query
  - `limit` integer: Maximum number of survey results to return
  - `target` 'all' | 'surveys' | 'answers': Which semantic namespace to query. Defaults to all; MCP survey and answer tools pin this server-side.
  - `filters` object
    - `includeEvidence` boolean: Whether to include matching snippets for each result

## Response `200`

Default Response

- object
  - `data` object[]
    - `id` string
    - `surveyGuid` string
    - `title` string
    - `question` string
    - `score` number
    - `matchedTypes` string[]
    - `evidence` object[]
      - `type` 'survey' | 'answer'
      - `id` string
      - `snippet` string
    - `metadata` object
      - `completedAt` string
      - `createdAt` string
      - `publishedAt` string
      - `updatedAt` string
      - `countryCode` string
      - `questionTypes` string[]
      - `tags` object[]
        - `id` string
        - `name` string
      - `projects` object[]
        - `id` string
        - `name` string
  - `meta` object
    - `limit` integer
    - `total` integer

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `409`: Default Response
- `502`: Default Response
- `503`: Default Response

---

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