Utility to iterate over FEC filings through the FEC API
Project description
Overview
fec-filing-iterator provides a simple interface for iterating through results from the Federal Election Commission’s API as a single, lazily evaluated stream. The FEC’s API provides access to a wealth of data on where candidates and committees get their funds, what they spend them on, and more. This library simply tries to make the API easier to work with in Python.
Getting Started
In order to use this library you will first need to get a data.gov API key, which you can request here. Once you get an API key you will be allowed to make 1,000 requests to the FEC API per hour. If you want more throughput you can request that your key be upgraded to be allowed to make 120 calls per minute by emailing APIinfo@fec.gov and asking nicely.
Next, you’ll have to install the library:
pip install fec-filing-iterator
Now you’re all set to start exploring campaign finance data! For example:
import json from fec_filing_iterator import schedules api_key = '<YOUR_DATA_DOT_GOV_API_KEY>' params = { 'two_year_transaction_period': 2020, 'committee_id': 'C00696948', } for filing in schedules('a', api_key=api_key, params=params): print(json.dumps(filing, indent=4))
Factories and Iterators
This library only tries to provide an easy way to access and iterate through the paginated results returned by the FEC API. It does not currently attempt to provide a full and consistent interface for retrieving arbitrary subsets of information from the API. Lots of powerful searches and queries can be parameterized through the API, but we leave it up to you to read the FEC’s documentation and find the appropriate parameters yourself.
The main workhorse of the library is the FilingIterator class. Construct it with API credentials, an API endpoint to iterate over, and whatever parameters you want, and you can treat the full set of records as one big iterable.
The library also provides several handy factory functions that will construct the FilingIterator object and configure it for the appropriate endpoint.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fec_filing_iterator-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 39bf2e5d1d0bf042d6f3201eb5533d16ab55a63acd64f71a0f034e9205721a1d |
|
MD5 | ede2eb95e634312c6d413be2f0fcdcdf |
|
BLAKE2b-256 | 86da7d35989531e33ca6aac0abeaa75177f78a8ae124f1559c1bb449f47bf5f7 |
Hashes for fec_filing_iterator-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ab3989d4022f0d7f3a9813a7d9e898e378087e54ed7efe763ef7cd21a07946aa |
|
MD5 | 580d4687c9f7bdf45da2c51e8cb2e14f |
|
BLAKE2b-256 | 5d5a559e8d791b027c6be63a7b2bb836665888974f010cc2d13eb3dca2e0ccb0 |