The SEC API allows you to search millions of SEC filings from thousands of public companies.
https://api.api-ninjas.com/v1/sec
Returns a list of SEC filing information (including the submission URL) corresponding to the given search parameters.
ticker
requiredTicker symbol of the company to search (e.g. AAPL
for Apple).
filing
requiredSEC filing form type. The following values are supported:
10-K |
10-Q |
S-1 |
S-2 |
S-3 |
8-K |
DEF14A |
13D |
start
optionalStart date to search. Must be in YYYY-MM-DD
format (e.g. 2023-04-01
).
end
optionalEnd date to search. Must be in YYYY-MM-DD
format (e.g. 2023-04-01
).
contains
optionalQuery text to search within filings. Only filings containing the text will be returned.
limit
optionalNumber of results to return (by default, all results will be returned, but if you want to save bandwidth and increase response speed, you can use this parameter).
X-Api-Key
requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=10-K
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
[
{
"accession_number": "0000320193-22-000108",
"submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019322000108/0000320193-22-000108.txt",
"filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019322000108/aapl-20220924.htm"
},
{
"accession_number": "0000320193-21-000105",
"submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019321000105/0000320193-21-000105.txt",
"filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019321000105/aapl-20210925.htm"
},
{
"accession_number": "0000320193-20-000096",
"submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019320000096/0000320193-20-000096.txt",
"filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019320000096/aapl-20200926.htm"
},
{
"accession_number": "0000320193-19-000119",
"submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019319000119/0000320193-19-000119.txt",
"filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019319000119/a10-k20199282019.htm"
}
]
1
2
3
4
5
6
7
8
import requests
api_url = 'https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=10-K'
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
print(response.text)
else:
print("Error:", response.status_code, response.text)
If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.