SEC-API.io Python Library

If your corporate IT infrastructure requires a proxy or causes SSL certificate errors, you can pass a proxies dictionary to all API wrappers (such as QueryApi and DownloadApi) during initialization. The dictionary should contain keys for http and https protocols.

from sec_api import QueryApi, DownloadApi, ...

proxies = {
  "http": "http://your-proxy.com",
  "https": "https://your-proxy.com",
}

queryApi = QueryApi(api_key="YOUR_API_KEY", proxies=proxies)
downloadApi = DownloadApi(api_key="YOUR_API_KEY", proxies=proxies)

Install the library using pip to access SEC EDGAR filings, exhibits, and datasets.

pip install sec-api

To retrieve Form 3 filings, initialize InsiderTradingApi and query for documentType:3. You can filter by issuer.tradingSymbol to find specific companies.

from sec_api import InsiderTradingApi

insiderTradingApi = InsiderTradingApi("YOUR_API_KEY")

data = insiderTradingApi.get_data({
    "query": "documentType:3 AND issuer.tradingSymbol:NTB",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
})
print(data["transactions"])

To retrieve Form 5 filings, initialize InsiderTradingApi and query for documentType:5.

from sec_api import InsiderTradingApi

insiderTradingApi = InsiderTradingApi("YOUR_API_KEY")

data = insiderTradingApi.get_data({
    "query": "documentType:5 AND issuer.tradingSymbol:SPWR",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
})
print(data["transactions"])

To retrieve Form 4 filings, initialize InsiderTradingApi and query for documentType:4. This is used to track changes in ownership by company officers, directors, and beneficial owners.

from sec_api import InsiderTradingApi

insiderTradingApi = InsiderTradingApi("YOUR_API_KEY")

data = insiderTradingApi.get_data({
    "query": "documentType:4 AND issuer.tradingSymbol:TSLA",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
})
print(data["transactions"])

You can use the items parameter in your query string to find specific sections within 8-K filings. For example, to find filings that include Item 9.01 ('Financial Statements and Exhibits'), use items:"9.01".

from sec_api import QueryApi

queryApi = QueryApi(api_key="YOUR_API_KEY")

# Find the most recently reported Form 8-K filings that include Item 9.01
query = {
  "query": "formType:\"8-K\" AND items:\"9.01\"",
  "from": "0",
  "size": "10",
  "sort": [{ "filedAt": { "order": "desc" } }]
}

filings = queryApi.get_filings(query)

Use AaerApi to access the Accounting and Auditing Enforcement Releases (AAER) database, which contains all AAERs filed from 1997 to the present. Use the .get_data(query) method to perform searches.

from sec_api import AaerApi

aaerApi = AaerApi("YOUR_API_KEY")

query = {
    "query": "dateTime:[2012-01-01 TO 2020-12-31]",
    "from": "0",
    "size": "50",
    "sort": [{"dateTime": {"order": "desc"}}],
}

response = aaerApi.get_data(query)
print(response["data"])

Use Form_8K_Item_X_Api to search for filings related to financial restatements or non-reliance on prior financial results. The data includes identified issues, affected reporting periods, affected financial statement items, and auditor involvement.

from sec_api import Form_8K_Item_X_Api

item_X_api = Form_8K_Item_X_Api("YOUR_API_KEY")

item_4_02_request = {
    "query": "item4_02:* AND filedAt:[2024-01-01 TO 2024-12-31]",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
}
item_4_02_response = item_X_api.get_data(item_4_02_request)
print(item_4_02_response["data"])

Use the Form1KApi class to query Form 1-K (annual reports) filed under Regulation A. You can search using specific identifiers like fileNo.

from sec_api import Form1KApi

form1KApi = Form1KApi("YOUR_API_KEY")

search_params = {
    "query": "fileNo:24R-00472",
    "from": "0",
    "size": "50",
    "sort": [{"filedAt": {"order": "desc"}}],
}

response = form1KApi.get_data(search_params)
form1Ks = response["data"]

print(form1Ks)