---
title: "Semantic filing search"
method: GET
path: "/v1/search/semantic"
---

# Semantic filing search

`GET /v1/search/semantic`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/search/semantic`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Semantic vector search across SEC filing section content with finance-tuned embeddings, hybrid keyword + vector RRF, and citation fields on every result row.

## Query parameters

- `q` string, required
- `mode` 'keyword' | 'semantic' | 'hybrid'
- `ticker` string
- `symbol` string
- `cik` string
- `form` string
- `filing_year` integer
- `limit` integer
- `view` 'default' | 'compact' | 'agent'

## Response `200`

Semantic search results with request tracing metadata.

- object
  - `object` 'semantic_search', required
  - `query` string, required
  - `mode` 'keyword' | 'semantic' | 'hybrid', required
  - `sections` object, required
    - `object` 'list', required
    - `data` object[], required
      - `object` 'section', required
      - `id` string, required
      - `ticker` string, nullable
      - `form` string
      - `key` string, required
      - `title` string, required
      - `contentMd` string, required
      - `snippet` string
      - `accession` string, nullable, required
      - `section_key` string, nullable, required
      - `char_start` integer, nullable, required
      - `char_end` integer, nullable, required
      - `highlighted_snippet` string, nullable, required
      - `source_url` string, uri, nullable, required
      - `score` number, nullable
      - `retrievalMode` 'keyword' | 'semantic' | 'hybrid'
      - `provenance` ResponseMetadata, required
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `accessionNumber` string, nullable, required
        - `filingUrl` string, uri, required
        - `acceptedAt` string, nullable
        - `retrievedAt` string, required
        - `parserVersion` string, required
    - `count` integer, required
    - `degradedState` object, nullable, required
  - `requestId` string, required
  - `traceparent` string, required

## Other responses

- `default`: Contract-aware error response

---

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