Semantic Filing Search
semantic_searchFind SEC filing SUB-SECTIONS semantically similar to a natural-language query (learned-sparse retrieval over the sub-section graph — Item 1A Risk Factors, Item 7 MD&A, Business, etc.). Unlike get_sentences (which filters by a known classifier name), this understands meaning: e.g. 'supply chain disruptions', 'interest rate sensitivity', 'workforce restructuring and severance'. Returns whole coherent sub-sections (more context than a single sentence). Optional filters: ticker, form ('10-K'/'10-Q'/'S-1'/'20-F'), sic, years, filed_before.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "semantic_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sic | No | Limit to companies with this SIC code (optional) | |
| form | No | Limit to a filing form type: '10-K', '10-Q', 'S-1', '20-F' (optional) | |
| limit | No | Max results to return (default: 10, max: 25) | |
| query | Yes | Natural-language query describing the filing language to find | |
| years | No | Filing years to search, e.g. [2025, 2026]. Default: all available years. | |
| ticker | No | Limit to a specific company ticker (optional; resolved to CIK) | |
| filed_before | No | Restrict to sub-sections whose filing_date <= this YYYY-MM-DD (point-in-time replay cutoff). |