secedgar

Download all companies periodic reports, filings and forms from EDGAR database.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

589

Maintenance

Last Commit

2mos ago

Contributors

20

Package

Dependencies

15

License

Apache License (2.0)

Categories

Readme

sec-edgar

|Tests Status| |Docs Status|

Getting filings of various companies at once is really a pain, but SEC-Edgar does that for you. You can download all of a company’s periodic reports, filings and forms from the EDGAR database with a single command.

Installation

You can install the package using pip:

.. code:: bash

$ pip install secedgar

OR

You can clone the project:

.. code:: bash

$ git clone https://github.com/sec-edgar/sec-edgar.git $ cd sec-edgar $ python setup.py install

Running

Company Filings


Single Company
^^^^^^^^^^^^^^

.. code:: python

    from secedgar import filings, FilingType

    # 10Q filings for Apple (ticker "aapl")
    my_filings = filings(cik_lookup="aapl",
                         filing_type=FilingType.FILING_10Q,
                         user_agent="Your name (your email)")
    my_filings.save('/path/to/dir')


Multiple Companies
^^^^^^^^^^^^^^^^^^

.. code:: python

    from secedgar import filings, FilingType

    # 10Q filings for Apple and Facebook (tickers "aapl" and "fb")
    my_filings = filings(cik_lookup=["aapl", "fb"],
                         filing_type=FilingType.FILING_10Q,
                         user_agent="Your name (your email)")
    my_filings.save('/path/to/dir')


Daily Filings
~~~~~~~~~~~~~


.. code:: python

    from secedgar import filings
    from datetime import date

    daily_filings = filings(start_date=date(2021, 6, 30),
                            user_agent="Your name (your email)")
    daily_urls = daily_filings.get_urls()



Supported Methods
-----------------

Currently this crawler supports many different filing types. To see the full list, please refer to the docs. If you don't see a filing type you would like
to be supported, please create an issue on GitHub.

Documentation
--------------
To learn more about the APIs and latest changes in the project, read the `official documentation <https://sec-edgar.github.io/sec-edgar>`_.


.. |Tests Status| image:: https://github.com/sec-edgar/sec-edgar/workflows/Tests/badge.svg
   :target: https://github.com/sec-edgar/sec-edgar/actions?query=workflow%3ATests
.. |Docs Status| image:: https://github.com/sec-edgar/sec-edgar/workflows/Build%20Docs/badge.svg
   :target: https://github.com/sec-edgar/sec-edgar/actions?query=workflow%3A%22Build+Docs%22

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100