← All guides

Locus product guide · Updated

SEC EDGAR API: free endpoints, rate limits and options

The SEC's EDGAR APIs on data.sec.gov are free, return JSON and need no API key. They cover each filer's submission history and the XBRL financial data from 10-K, 10-Q, 8-K and similar filings, through the submissions, companyconcept, companyfacts and frames endpoints. The SEC caps automated access at 10 requests per second and asks every script to declare a User-Agent with a company name and contact email. Paid services such as SEC-API.io, from $49 a month, add parsed sections and search on top. Prices checked November 10, 2026.

What does the official SEC EDGAR API include?

Four JSON APIs on data.sec.gov, plus nightly bulk files. The SEC says they need no authentication or API keys, and update in real time as filings are disseminated. Each company is addressed by its 10-digit CIK, including leading zeros.

What does the official SEC EDGAR API include?
EndpointURL patternReturns
Submissionsdata.sec.gov/submissions/CIK##########.jsonName, tickers, exchanges and at least 1 year or 1,000 of the most recent filings
Company conceptdata.sec.gov/api/xbrl/companyconcept/CIK##########/us-gaap/AccountsPayableCurrent.jsonEvery reported value of one XBRL tag for one company
Company factsdata.sec.gov/api/xbrl/companyfacts/CIK##########.jsonAll XBRL facts for one company in one file
Framesdata.sec.gov/api/xbrl/frames/us-gaap/AccountsPayableCurrent/USD/CY2019Q1I.jsonOne fact per company for one calendar period
Bulk ZIP filescompanyfacts.zip and submissions.zipEverything above, rebuilt nightly at about 3:00 a.m. ET

What are the SEC EDGAR rate limits and User-Agent rules?

The SEC’s fair access page says: "Current max request rate: 10 requests/second." It asks you to download only what you need and reserves the right to limit request rates.

Every script must declare a User-Agent. The SEC’s sample is "Sample Company Name AdminContact@<sample company domain>.com". The SEC also states it does not allow botnets or automated crawling outside this policy.

Two more limits catch people. data.sec.gov does not support CORS, so a browser page cannot call it directly. And the SEC offers no technical support for scripted downloads.

What does the free EDGAR API not give you?

The data.sec.gov APIs return filing lists and tagged financial facts. They do not return cleaned text sections, such as Item 1A risk factors from a 10-K, or parsed insider trades.

EDGAR full-text search covers every electronic filing since 2001, including exhibits. The SEC documents it as a search tool on its website, not as one of the data.sec.gov APIs.

Processing is fast but not instant. The SEC lists a typical delay under 1 second for submissions and under 1 minute for XBRL data, longer at peak filing times.

How do I query EDGAR through Locus Pro?

Locus Pro wraps the official EDGAR endpoints, and SEC full-text search, as tools an agent can call. The agent reads each call’s credit price for free before it runs.

What Locus adds is convenience, not data: your agent finds the endpoint, Locus makes the request to the SEC for you, and the call lands on the same prepaid balance as your other tools.

How do I query EDGAR through Locus Pro?
Locus endpointWhat it returnsSource
EDGAR company submissionsFiler details and recent filingsdata.sec.gov submissions
EDGAR company factsEvery XBRL fact for one companydata.sec.gov companyfacts
EDGAR company conceptAll values of one XBRL tag for one companydata.sec.gov companyconcept
EDGAR full-text searchFilings that match a search querySEC full-text search, filings since 2001

Should I call the SEC from my own code or through an agent tool?

Call the SEC yourself whenever you write code. For example, 10 years of revenue for 50 companies takes 50 company facts calls, about 5 seconds at the 10 a second limit.

For the whole market, skip the API and download companyfacts.zip each night.

Use Locus when an agent answers ad hoc questions, such as "What did these three companies report for R&D last year?", and you do not want to build and host a client for one more API.

Which SEC data source should I choose?

Pick by how much parsing you want someone else to do.

  • Financial statement numbers in your own code: the free XBRL APIs.
  • Every company at once: the nightly bulk ZIP files.
  • Parsed 10-K sections or full-text search by API: SEC-API.io.
  • Fundamentals plus prices in one vendor: Financial Modeling Prep.
  • An agent that looks up filings now and then next to other data: Locus Pro.

Frequently asked questions

Do I need an API key for the SEC EDGAR API?

No. The SEC says the data.sec.gov APIs need no authentication or API key. You must still send a User-Agent with your company name and a contact email.

What happens if I go over 10 requests per second?

The SEC reserves the right to limit your request rate to keep access fair for everyone. Pace your script below 10 a second and use the bulk files for large jobs.

Can I call data.sec.gov from a web page?

Not directly. data.sec.gov does not support CORS, so browser JavaScript is blocked. Call it from a server or an agent tool instead.

How fresh is EDGAR API data?

The SEC lists a typical delay under 1 second for submissions and under 1 minute for XBRL facts. The bulk ZIP files rebuild nightly at about 3:00 a.m. ET.

Implementation references

Use these first-party references for current request contracts and account requirements. Tool availability, prices, and negotiated terms can change.

Sources

Third-party details were checked on November 10, 2026. Vendors change pricing and features often, so confirm on their site before you decide.

Related guides