{ "info": { "author": "Jad Chaar", "author_email": "jad.chaar@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Intended Audience :: Financial and Insurance Industry", "Intended Audience :: Information Technology", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3 :: Only", "Topic :: Office/Business :: Financial", "Topic :: Office/Business :: Financial :: Investment", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "sec-edgar-downloader\n====================\n\n.. image:: https://travis-ci.org/jadchaar/sec-edgar-downloader.svg?branch=master\n :alt: Build Status\n :target: https://travis-ci.org/jadchaar/sec-edgar-downloader\n\n.. image:: https://codecov.io/gh/jadchaar/sec-edgar-downloader/branch/master/graph/badge.svg\n :alt: Coverage Status\n :target: https://codecov.io/gh/jadchaar/sec-edgar-downloader\n\n.. image:: https://img.shields.io/pypi/v/sec-edgar-downloader.svg\n :alt: PyPI Version\n :target: https://python.org/pypi/sec-edgar-downloader\n\n.. image:: https://img.shields.io/pypi/pyversions/sec-edgar-downloader.svg\n :alt: Supported Python Versions\n :target: https://python.org/pypi/sec-edgar-downloader\n\n.. image:: https://img.shields.io/pypi/l/sec-edgar-downloader.svg\n :alt: License\n :target: https://python.org/pypi/sec-edgar-downloader\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :alt: Code Style: Black\n :target: https://github.com/python/black\n\n**sec-edgar-downloader** is a Python package for downloading `company filings `_ from the `SEC EDGAR database `_. Searches can be conducted either by `stock ticker `_ or `Central Index Key (CIK) `_. You can use the `SEC CIK lookup tool `_ if you cannot find an appropriate ticker.\n\nQuick Start\n-----------\n\nInstallation\n^^^^^^^^^^^^\n\nInstall and update this package using `pip `_ or `pipenv `_:\n\n.. code-block:: console\n\n $ pip install -U sec-edgar-downloader\n\nExample Usage\n^^^^^^^^^^^^^\n\n.. code-block:: python\n\n from sec_edgar_downloader import Downloader\n\n # Initialize a downloader instance.\n # If no argument is passed to the constructor, the package\n # will attempt to locate the user's downloads folder.\n dl = Downloader(\"/path/to/valid/save/location\")\n\n # Get all 8-K filings for Apple (ticker: AAPL)\n dl.get_8k_filings(\"AAPL\")\n\n # Get all 8-K filings for Apple, including filing amends (8-K/A)\n dl.get_8k_filings(\"AAPL\", include_amends=True)\n\n # Get all 8-K filings for Apple before March 25, 2017\n # Note: before_date string must be in the form \"YYYYMMDD\"\n dl.get_8k_filings(\"AAPL\", before_date=\"20170325\")\n\n # Get the past 5 8-K filings for Apple\n dl.get_8k_filings(\"AAPL\", 5)\n\n # Get all 10-K filings for Microsoft (ticker: MSFT)\n dl.get_10k_filings(\"MSFT\")\n\n # Get the latest 10-K filing for Microsoft\n dl.get_10k_filings(\"MSFT\", 1)\n\n # Get the latest 10-KSB filing for Ubiquitech Software\n dl.get_10ksb_filings(\"0001411460\", 1)\n\n # Get all 10-Q filings for Visa (ticker: V)\n dl.get_10q_filings(\"V\")\n\n # Get all 13F-NT filings for the Vanguard Group (CIK: 0000102909)\n dl.get_13f_nt_filings(\"0000102909\")\n\n # Get all 13F-HR filings for the Vanguard Group\n dl.get_13f_hr_filings(\"0000102909\")\n\n # Get all SC 13G filings for Apple\n dl.get_sc_13g_filings(\"AAPL\")\n\n # Get all SD filings for Apple\n dl.get_sd_filings(\"AAPL\")\n\n # Get the latest filings (8-K, 10-K, 10-Q, 13F, SC 13G, SD), if available, for Apple\n dl.get_all_available_filings(\"AAPL\", 1)\n\n # Get the latest filings (8-K, 10-K, 10-Q, 13F, SC 13G, SD), if available, for a\n # specified list of tickers and CIKs\n symbols = [\"AAPL\", \"MSFT\", \"0000102909\", \"V\", \"FB\"]\n for s in symbols:\n dl.get_all_available_filings(s, 1)\n\nSupported SEC Filings\n---------------------\n\n- 8-K\n- 10-K\n- 10-KSB\n- 10-Q\n- 13F-NT and 13F-HR\n- SC 13G\n- SD\n\nYou can learn more about the different types of SEC filings `here `_.\n\nContributing\n------------\n\nIf you encounter a bug or would like to see a new company filing or feature added to **sec-edgar-downloader**, please `file an issue `_ or `submit a pull request `_.\n\nDocumentation\n-------------\n\nFor full documentation, please visit `sec-edgar-downloader.readthedocs.io `_.\n\n\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/jadchaar/sec-edgar-downloader", "keywords": "sec edgar filing financial finance sec.gov", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "sec-edgar-downloader", "package_url": "https://pypi.org/project/sec-edgar-downloader/", "platform": "", "project_url": "https://pypi.org/project/sec-edgar-downloader/", "project_urls": { "Bug Reports": "https://github.com/jadchaar/sec-edgar-downloader/issues", "Documentation": "https://sec-edgar-downloader.readthedocs.io", "Homepage": "https://github.com/jadchaar/sec-edgar-downloader", "Repository": "https://github.com/jadchaar/sec-edgar-downloader" }, "release_url": "https://pypi.org/project/sec-edgar-downloader/2.2.1/", "requires_dist": [ "lxml (>=4.3.4)", "requests (>=2.22.0)" ], "requires_python": ">=3.6", "summary": "Download SEC filings from the EDGAR database using Python.", "version": "2.2.1" }, "last_serial": 5851308, "releases": { "2.0.0": [ { "comment_text": "", "digests": { "md5": "4d93e8cd967359fc6b478bdfa1772edf", "sha256": "997e35d03457ab220e0862acd7db045ddac976309d62509126c5ab37a6ea7461" }, "downloads": -1, "filename": "sec_edgar_downloader-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "4d93e8cd967359fc6b478bdfa1772edf", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 6089, "upload_time": "2019-05-14T02:49:36", "url": "https://files.pythonhosted.org/packages/0e/fa/b6144d59037f61583759f2ffdca7b4f474f6abb89e8bc2b9ec27233fc886/sec_edgar_downloader-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c8fbebf2004178f44bff72ac0e44e1e2", "sha256": "be7de8f0a76e1b87d2ec9a783c880358633d40ef4b2c037ba06e5e9f275b5744" }, "downloads": -1, "filename": "sec_edgar_downloader-2.0.0.tar.gz", "has_sig": false, "md5_digest": "c8fbebf2004178f44bff72ac0e44e1e2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 5038, "upload_time": "2019-05-14T02:49:38", "url": "https://files.pythonhosted.org/packages/df/d9/91da850d6f3faa7acfc88b7705a35444c35d1d03e2677991f2f5553abb17/sec_edgar_downloader-2.0.0.tar.gz" } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "057361bbd815de0e3eb5aa6c6bfb4aa0", "sha256": "cf0924bf86acc02ae0f7d553456295c06a5c35989cf921662ea5b30eb928a89d" }, "downloads": -1, "filename": "sec_edgar_downloader-2.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "057361bbd815de0e3eb5aa6c6bfb4aa0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 6089, "upload_time": "2019-05-14T03:03:47", "url": "https://files.pythonhosted.org/packages/3b/c6/c94550fbba5a913d95414592dbe3cb624965070c0df0c0aa53f83f81542f/sec_edgar_downloader-2.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f6545c1eb801a4f048664d64b6f81bd2", "sha256": "7ee66e4f956c4dabaefbc684409252a387307725af7257bb54784be312065071" }, "downloads": -1, "filename": "sec-edgar-downloader-2.0.1.tar.gz", "has_sig": false, "md5_digest": "f6545c1eb801a4f048664d64b6f81bd2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 5035, "upload_time": "2019-05-14T03:03:48", "url": "https://files.pythonhosted.org/packages/da/32/36e8aee0f385505abad7639b73189a05c6ad0c62b039c199d356667d1718/sec-edgar-downloader-2.0.1.tar.gz" } ], "2.1.0": [ { "comment_text": "", "digests": { "md5": "a0ca58efdf699d5bd0521a0c43aed296", "sha256": "5b7452deec52c9aacc33840678f6a5e48fe2398a0900a3435adddd8a27be09f8" }, "downloads": -1, "filename": "sec_edgar_downloader-2.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "a0ca58efdf699d5bd0521a0c43aed296", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 6993, "upload_time": "2019-06-09T02:33:19", "url": "https://files.pythonhosted.org/packages/b5/f7/32e009fb4c28b981e10f6b58bc27a4134a55d4bdaf04a82a3f42f5634ad0/sec_edgar_downloader-2.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "dbaae0de7089910cdef84e9180b17402", "sha256": "a69aa5ce42ca252b1d1093b4667a3411b72aab21876bae7b610d6ab2819ac014" }, "downloads": -1, "filename": "sec-edgar-downloader-2.1.0.tar.gz", "has_sig": false, "md5_digest": "dbaae0de7089910cdef84e9180b17402", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 5325, "upload_time": "2019-06-09T02:33:21", "url": "https://files.pythonhosted.org/packages/a6/bb/fb0db64448ed7932cb8072b446130f84f4c5859bd366b5574fbaabf4a1f3/sec-edgar-downloader-2.1.0.tar.gz" } ], "2.2.0": [ { "comment_text": "", "digests": { "md5": "583115c07f86a7ddfdbe56e9d1333b22", "sha256": "ca873081e2c797eae7ec2280a3262d1bf75043d8ff7cdea2815a3e4eb4213d0e" }, "downloads": -1, "filename": "sec_edgar_downloader-2.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "583115c07f86a7ddfdbe56e9d1333b22", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 8303, "upload_time": "2019-06-29T04:12:36", "url": "https://files.pythonhosted.org/packages/b1/13/407c1cd2b98a2d04cdc72810458d3358243a67d9b4536f042c5f313de22d/sec_edgar_downloader-2.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e5f7bdbc3429c451b4ff58223d979baf", "sha256": "610b6fc97d6148fffd985afb2ca0bb215eaa770167f8f5e3910f0e757bded62f" }, "downloads": -1, "filename": "sec-edgar-downloader-2.2.0.tar.gz", "has_sig": false, "md5_digest": "e5f7bdbc3429c451b4ff58223d979baf", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 8237, "upload_time": "2019-06-29T04:12:38", "url": "https://files.pythonhosted.org/packages/91/2d/ff5d20f79e94608545aa48a26bc7f239ed97df202b013ef9a897bcb6d8f5/sec-edgar-downloader-2.2.0.tar.gz" } ], "2.2.1": [ { "comment_text": "", "digests": { "md5": "9dcb8fad5925f32dec6538497c8e8bb7", "sha256": "f0985931581952333432780a883de5a962efae1f7d306e5371fc416a4c87ea81" }, "downloads": -1, "filename": "sec_edgar_downloader-2.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9dcb8fad5925f32dec6538497c8e8bb7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 8427, "upload_time": "2019-09-18T16:34:11", "url": "https://files.pythonhosted.org/packages/d0/44/6cab3422c041d3befa35fc0ec5916782c3309994747cd217e196d26acbc2/sec_edgar_downloader-2.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e5d5062a4329fdfd60fee18d9d835de4", "sha256": "d0b72ac1b98be62907e260c3e8bc2b76581cb89b78d1756718bbece995d12d81" }, "downloads": -1, "filename": "sec-edgar-downloader-2.2.1.tar.gz", "has_sig": false, "md5_digest": "e5d5062a4329fdfd60fee18d9d835de4", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 8392, "upload_time": "2019-09-18T16:34:13", "url": "https://files.pythonhosted.org/packages/4a/1f/79be6474e2b9b430a7d8f1cb5dad5774625469a51aa7da27b4d21e1a34b6/sec-edgar-downloader-2.2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9dcb8fad5925f32dec6538497c8e8bb7", "sha256": "f0985931581952333432780a883de5a962efae1f7d306e5371fc416a4c87ea81" }, "downloads": -1, "filename": "sec_edgar_downloader-2.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9dcb8fad5925f32dec6538497c8e8bb7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 8427, "upload_time": "2019-09-18T16:34:11", "url": "https://files.pythonhosted.org/packages/d0/44/6cab3422c041d3befa35fc0ec5916782c3309994747cd217e196d26acbc2/sec_edgar_downloader-2.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e5d5062a4329fdfd60fee18d9d835de4", "sha256": "d0b72ac1b98be62907e260c3e8bc2b76581cb89b78d1756718bbece995d12d81" }, "downloads": -1, "filename": "sec-edgar-downloader-2.2.1.tar.gz", "has_sig": false, "md5_digest": "e5d5062a4329fdfd60fee18d9d835de4", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 8392, "upload_time": "2019-09-18T16:34:13", "url": "https://files.pythonhosted.org/packages/4a/1f/79be6474e2b9b430a7d8f1cb5dad5774625469a51aa7da27b4d21e1a34b6/sec-edgar-downloader-2.2.1.tar.gz" } ] }