Docs / API reference

GET /v1/search/fulltext

Search the full text of every SEC filing since 2001 — the same index behind EDGAR full-text search. Returns the matching filing documents with company, form, date, 8-K item codes, and a link to the document on SEC.gov. Filter by form and date range; page with offset.

Parameters

ParamInValues
qqueryRequired. Quote a phrase ("climate change") for an exact match; space-separated terms are ANDed
formsqueryComma-separated form filter, e.g. 8-K or 10-K,10-Q
startdtqueryOnly filings on/after this date, YYYY-MM-DD
enddtqueryOnly filings on/before this date, YYYY-MM-DD
limitquery1–100 (default 20)
offsetqueryPagination offset into the result set (default 0)

Request

curl "https://api.edgrapi.com/v1/search/fulltext?q=%22climate+change%22&forms=8-K&startdt=2024-01-01&enddt=2024-03-31" \
  -H "X-API-Key: edgr_..."

Response

{
  "query": "\"climate change\"", "forms": "8-K",
  "start": "2024-01-01", "end": "2024-03-31",
  "total": 973, "count": 20,
  "hits": [
    { "form": "8-K", "filed": "2024-02-15",
      "company": "CONSOLIDATED EDISON INC  (ED)  (CIK 0001047862)",
      "ciks": [ "0001047862" ], "accession": "0001047862-24-000013",
      "items": [ "2.02", "9.01" ], "period": "2024-02-15",
      "file_type": "EX-99.2",
      "url": "https://www.sec.gov/Archives/edgar/data/1047862/000104786224000013/a4q2023earningsreleasepr.htm" }
  ],
  "source": "SEC EDGAR full-text search (efts.sec.gov)"
}

total is the full match count (capped at 10,000 by the index); count is how many hits this page returned. A search that matches nothing returns count: 0 and is free.

Cost: 1 credit.