Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Full-Text & Semantic Search API

Search SEC filings and documents using keyword, semantic, or hybrid retrieval. Use keyword, semantic, or hybrid retrieval with reciprocal rank fusion (RRF) for queries that benefit from both exact terms and conceptual matches.

​
Why use this

Traditional filing search is keyword-only. SEC API Search adds semantic retrieval so you can find filings by concept, not just exact terms. Hybrid mode fuses keyword and vector results using RRF scoring for the best of both approaches.
  • Keyword and semantic retrieval — use full-text search for exact terms and semantic search for conceptual matches
  • Semantic retrieval — find filing sections by concept, not only exact keyword matches
  • Score transparency — every result includes a relevance score and the retrieval mode used
  • Filing-scoped — results link directly to filing sections and source documents

​
Quick start

# Keyword search
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/search/fulltext?q=revenue+recognition+policy&limit=5"

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/search/semantic?q=companies+discussing+supply+chain+risks+in+asia&mode=semantic&limit=10"

​
Example: semantic search in agent view

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/search/semantic?q=goodwill+impairment+risk+factors&mode=semantic&view=agent&limit=10"

​
Response shape

{
  "results": [
    {
      "accessionNumber": "0000320193-23-000077",
      "ticker": "AAPL",
      "companyName": "Apple Inc.",
      "form": "10-K",
      "sectionKey": "item1a",
      "excerpt": "The Company is subject to risks associated with...",
      "score": 0.892,
      "retrievalMode": "semantic"
    }
  ],
  "pagination": {
    "total": 1240,
    "page": 1,
    "limit": 10
  },
  "meta": {
    "queryTimeMs": 142,
    "retrievalMode": "semantic"
  }
}

​
Key parameters

ParameterTypeDescription
qstringSearch query (required)
modestringRetrieval mode for semantic search
tickerstringScope to a specific company
formstringFilter by form type
filing_yearstringFilter semantic search by filing year
viewstringUse agent for compact agent-ready rows
limitnumberResults per page (max 50)

​
Rate limits

Rate limits vary by plan and workload. Semantic queries consume more compute than keyword queries, so use the billing and usage endpoints to inspect your current quota.