Semantic filing search

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

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

Query parameters

qstring required

Search query

mode'keyword' | 'semantic' | 'hybrid'

Retrieval mode (default hybrid). Invalid values return invalid_query_parameter with acceptedValues.

tickerstring

Optional issuer ticker filter. symbol is accepted as an alias.

symbolstring

Alias for ticker, for customers coming from market-data APIs. If both ticker and symbol are provided, they must match.

cikstring
formstring
filing_yearinteger
limitinteger
view'default' | 'compact' | 'agent'

Search response shape. Pass agent to drop score and retrievalMode while preserving citation fields; compact is accepted for response-format consistency and currently matches the default search rows. Invalid values return invalid_query_parameter with details.acceptedValues.

Response

Semantic search results with request tracing metadata.

object'semantic_search' required
querystring required
mode'keyword' | 'semantic' | 'hybrid' required
requestIdstring required
traceparentstring required

Changes

No recorded changes to this operation across all 1 revision of this API.