---
title: "Search source snippets"
method: GET
path: "/v1/search"
---

# Search source snippets

`GET /v1/search`

## Request

- Base URL: `https://app.takibibase.com`
- URL: `https://app.takibibase.com/v1/search`
- Auth: HTTP bearer

Requires search capability. Returns ranked snippets, not full document text.

## Query parameters

- `q` string, required
- `projectId` string, uuid
- `folderId` string, uuid
- `k` integer

## Response `200`

Successful response.

- object
  - `results` SearchHit[], required
    - `chunkId` string, uuid
    - `documentId` string, uuid
    - `documentName` string
    - `title` string
    - `snippet` string
    - `rank` number
    - `documentCreatedAt` string
    - `ttlDays` integer

## Other responses

- `400`: Invalid request.
- `401`: Missing, invalid, paused or revoked key, or human-only route.
- `403`: Capability or access denied.
- `404`: Resource not found or not visible.
- `429`: Daily budget spent (error.code DAILY_BUDGET_EXCEEDED) or minute throttle (RATE_LIMITED).

---

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