Text Search API

Full-text search across SEC filing content with highlighted snippets

Overview

Endpoint

GET api.secblast.com/v1/search

Description

Search for specific content within filing documents. The corpus contains the full text of all electronic filings from 1993 to present. New filings are added as they are published by the SEC. In beta, responses are limited to the first 200 results.

Request Parameters

Parameter	Type	Description
api_key	string	RequiredYour API key
query	string	RequiredThe search query string
ciks	string	Comma-separated list of CIK numbers to filter results
tickers	string	Comma-separated list of ticker symbols to filter results
document_ids	string	Comma-separated list of document IDs to filter results
sics	string	Comma-separated list of SIC codes to filter results
form_types	string	Comma-separated list of form types to filter results
from_date	string	Start date in ISO format (YYYY-MM-DD)
to_date	string	End date in ISO format (YYYY-MM-DD)

Response Format

{
  "total_count": 3,
  "items": [
    {
      "related_company_names": ["TESLA, INC."],
      "ciks": ["0001318605"],
      "accnum": "0000950103-24-012380",
      "filename": "tsla-20240630.htm",
      "filing_date": "2024-07-24",
      "form_type": "10-Q",
      "snippet": "As of June 30, 2024, our automotive cost reduction initiatives resulted in a 16% decline in cost of goods sold per vehicle compared to the prior year period for the same quarter. Tesla's ongoing focus on <mark>financial results</mark> and operational efficiency continued to drive improvement in our gross margins.",
      "score": 0.79853,
      "document_id": "0000950103-24-012380-1"
    },
    {
      "related_company_names": ["TESLA, INC."],
      "ciks": ["0001318605"],
      "accnum": "0000950103-24-002390",
      "filename": "tsla-20231231.htm",
      "filing_date": "2024-01-29",
      "form_type": "10-K",
      "snippet": "Tesla's <mark>financial results</mark> for the full year 2023 demonstrated strong performance across all business segments, with total revenues of $96.8 billion and net income of $15.0 billion.",
      "score": 0.75321,
      "document_id": "0000950103-24-002390-1"
    },
    {
      "related_company_names": ["TESLA, INC."],
      "ciks": ["0001318605"],
      "accnum": "0000950103-23-007432",
      "filename": "tsla-20230630.htm",
      "filing_date": "2023-07-24",
      "form_type": "10-Q",
      "snippet": "The second quarter 2023 <mark>financial results</mark> reflected continued growth in vehicle deliveries and energy storage deployments. Tesla achieved record quarterly revenues of $24.9 billion.",
      "score": 0.72186,
      "document_id": "0000950103-23-007432-1"
    }
  ]
}

Example Request

curl "https://api.secblast.com/v1/search?api_key=YOUR_API_KEY&query=financial+results&tickers=TSLA"

Error Responses

401 Unauthorized: Invalid API key

{
  "total_count": 0,
  "items": [],
  "error": "Invalid API key"
}

400 Bad Request: Missing query parameter

{
  "total_count": 0,
  "items": [],
  "error": "Query parameter is required"
}