SEC Blast API

GET/v2/fulltext_search

Full-text search across SEC filing documents using Elasticsearch. Supports match, phrase, and Lucene query syntax with entity and date filters.

Request Parameters

Name	Type	Description
`api_key`required	string	Your API key.
`query`required	string	Search query string.
`query_type`	string	Query type: match (default), match_phrase, query_string
`entity_query`	object	Filter by entities using entity_lookup fields
`ciks`	string[]	Direct CIK filter (alternative to entity_query)
`form_types`	string[]	Form types to search. Example: `["10-K", "10-Q"]`
`accession_numbers`	string[]	Filter to specific filings. Use with filing_lookup for entity-filtered text search.
`date_from`	string	Start date. Example: `YYYY-MM-DD`
`date_to`	string	End date. Example: `YYYY-MM-DD`
`from`	number	Pagination start. Default: 0
`to`	number	Pagination end. Default: 100, Max: 10000

Query Types

match (default)

Finds documents containing all words (order doesn't matter).

"query": "artificial intelligence"

match_phrase

Finds exact phrase matches.

"query": "artificial intelligence",
"query_type": "match_phrase"

query_string (Lucene syntax)

Supports boolean operators and advanced syntax:

AND - Both terms required: revenue AND growth
OR - Either term: merger OR acquisition
NOT - Exclude term: profit AND NOT loss
+/- - Shorthand: +revenue +growth -loss
* - Wildcard: acqui*
"" - Exact phrase: "material contract"
() - Grouping: (merger OR acquisition) AND agreement

"query": "(revenue OR sales) AND growth AND NOT loss",
"query_type": "query_string"

Examples

Basic Search

bash

curl "https://api.secblast.com/v2/fulltext_search?api_key=YOUR_KEY&query=artificial%20intelligence"

Search with Filters

bash

curl -X GET "https://api.secblast.com/v2/fulltext_search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "query": "cybersecurity risk",
    "form_types": ["10-K"],
    "date_from": "2023-01-01",
    "entity_query": {"exchanges": ["NASDAQ"]}
  }'

Boolean Query

bash

curl -X GET "https://api.secblast.com/v2/fulltext_search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "query": "(merger OR acquisition) AND agreement",
    "query_type": "query_string",
    "form_types": ["8-K"]
  }'

200Success

{
  "count": 150,
  "results": [
    {
      "accession_number": "0000320193-24-000081",
      "document_id": "0000320193-24-000081-1",
      "cik": "320193",
      "entity_name": "Apple Inc.",
      "form_type": "10-K",
      "filing_date": "2024-11-01",
      "filename": "aapl-20240928.htm",
      "score": 25.4,
      "highlights": [
        "...investments in <em>artificial intelligence</em> and machine learning..."
      ]
    }
  ],
  "truncated": false
}