{"id":44682,"library":"datamule","title":"DataMule","description":"Work with SEC submissions at scale. Current version 3.7.0. Frequent releases.","status":"active","version":"3.7.0","language":"python","source_language":"en","source_url":"https://github.com/john-friedman/datamule-python","tags":["sec","edgar","filings","financial-data"],"install":[{"cmd":"pip install datamule","lang":"bash","label":"pip install"}],"dependencies":[],"imports":[{"wrong":"from datamule import Client","symbol":"Book","correct":"from datamule import Book"},{"symbol":"Document","correct":"from datamule import Document"},{"symbol":"Portfolio","correct":"from datamule import Portfolio"}],"quickstart":{"code":"from datamule import Client\nimport os\n\nclient = Client(api_key=os.environ.get('DATAMULE_API_KEY', ''))\nsubmissions = client.get_submissions(ticker='AAPL', count=2)\nprint(submissions)","lang":"python","description":"Initialize client and fetch basic SEC submissions."},"warnings":[{"fix":"Pass `api_key` parameter to `Client()` or set env var `DATAMULE_API_KEY`.","message":"API key is now required and passed to Client constructor; environment variable changed from `SEC_API_KEY` to `DATAMULE_API_KEY`.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use `client.get_submissions(ticker='AAPL')` instead of `client.get_submissions('AAPL')`.","message":"`get_submissions` no longer accepts `ticker` as a positional argument; must be keyword.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Replace `client.get_filings(...)` with `client.get_submissions(...)`.","message":"`get_filings` method is deprecated; use `get_submissions` instead.","severity":"deprecated","affected_versions":">=3.5.0"},{"fix":"Use built-in throttling via `RateLimiter` or add `time.sleep(0.1)` between calls.","message":"Rate limiting: 10 requests per second for free tier; exceeding returns 429 errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'3.7.0':10 'current':8 'data':18 'datamul':1 'edgar':14 'file':15 'financi':17 'financial-data':16 'frequent':11 'releas':12 'scale':7 'sec':4,13 'submiss':5 'version':9 'work':2","created_at":"2026-06-07T12:51:19.714980+00:00","updated_at":"2026-06-07T12:51:19.714980+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/john-friedman/datamule-python","github":"https://github.com/john-friedman/datamule-python","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}