Search Documents

GET/v1/search

Perform full-text search across SEC filing documents with advanced filtering and relevance scoring.

Parameters

Name	Type	Required	Description
`api_key`	string	Required	Your API authentication key `Example: sk_live_abc123...`
`query`	string	Required	The search query string. Supports keywords, phrases (in quotes), and boolean operators `Example: "climate risk" OR "environmental impact"`
`cik`	string	Optional	Comma-separated list of CIK numbers to filter results `Example: 0001318605,0001640147`
`ticker`	string	Optional	Comma-separated list of ticker symbols to filter results `Example: TSLA,AAPL`
`ids`	string	Optional	Comma-separated list of specific document IDs to search within `Example: 0001318605-24-000008-1,0001318605-24-000009-1`
`sic`	string	Optional	Comma-separated list of SIC codes to filter results `Example: 3711,7372`
`formType`	string	Optional	Comma-separated list of form types to filter results `Example: 10-K,10-Q,8-K`
`from_date`	string	Optional	Start date for filing date range (ISO 8601 format) `Example: 2024-01-01`
`to_date`	string	Optional	End date for filing date range (ISO 8601 format) `Example: 2024-12-31`
`limit`	integer	Optional	Maximum number of results to return (default: 20, max: 100) `Example: 50`
`offset`	integer	Optional	Number of results to skip for pagination (default: 0) `Example: 20`

Examples

Request

curl -X GET "https://api.secblastapi.com/v1/search?query=climate%20risk&formType=10-K&from_date=2024-01-01" \
  -H "X-API-Key: your_api_key"

Response

{
  "total_count": 247,
  "items": [
    {
      "related_company_names": ["TESLA, INC."],
      "ciks": ["0001318605"],
      "accnum": "0001318605-24-000008",
      "filename": "tsla-20231231.htm",
      "filing_date": "2024-01-29",
      "form_type": "10-K",
      "snippet": "...We face risks related to <mark>climate</mark> change and the global transition to a lower carbon economy, including physical <mark>risks</mark> from extreme weather events...",
      "score": 0.9234,
      "document_id": "0001318605-24-000008-1"
    },
    {
      "related_company_names": ["APPLE INC"],
      "ciks": ["0000320193"],
      "accnum": "0000320193-24-000008",
      "filename": "aapl-20230930.htm",
      "filing_date": "2024-02-02",
      "form_type": "10-K",
      "snippet": "...Our operations are subject to <mark>climate</mark>-related <mark>risks</mark> including regulatory changes, physical impacts, and transition risks...",
      "score": 0.8976,
      "document_id": "0000320193-24-000008-1"
    }
  ]
}

Response Schema

total_count

Type: integer

Total number of documents matching the search query

items

Type: array

Array of search result objects

related_company_names:Array of company names associated with the filing

ciks:Array of CIK numbers for the filing entities

accnum:Accession number of the filing

filename:Name of the document file

filing_date:Date the filing was submitted

form_type:Type of SEC form

snippet:Text excerpt showing the search query in context (with <mark> tags)

score:Relevance score (0-1, higher is more relevant)

document_id:Unique identifier for the document

Error Responses

400Bad Request - Missing or invalid query

{
  "error": "Missing query parameter"
}

401Unauthorized - Invalid or missing API key

{
  "error": "Invalid API key"
}

429Too Many Requests - Rate limit exceeded

{
  "error": "Rate limit exceeded. Please try again later."
}

Important Notes

• Search results are sorted by relevance score by default
• The snippet field contains matched text with search terms highlighted using <mark> tags
• Boolean operators (AND, OR, NOT) are supported in queries
• Phrase searches are supported using double quotes
• Wildcards (*) are supported for partial word matching
• Results are limited to documents where full text is available
• Search is case-insensitive
• Maximum query length is 1000 characters

Try It Out

Test this endpoint interactively in our API Playground

Open in Playground →