# FEC Campaign Finance Intelligence (`wakey7dev/fec-campaign-finance`) Actor Search and normalize US campaign finance data: contributions, committees, and candidates. Free API, no key required. - **URL**: https://apify.com/wakey7dev/fec-campaign-finance.md - **Developed by:** [Chris Wakefield](https://apify.com/wakey7dev) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![Chris The Dev](https://raw.githubusercontent.com/chriswakefield87/appstore-screenshot-translator/main/assets/actor-banner.png) ## FEC Campaign Finance Intelligence 🔍💰 Search and normalize US Federal Election Commission campaign finance data — individual contributions, committee details, and candidate filings. Powered by the official [FEC API](https://api.open.fec.gov) (free, no API key required). ### ✨ Features - **Individual Contributions** — search by donor name, employer, or occupation - **Committee Search** — find PACs, campaign committees, and party committees - **Candidate Lookup** — search active candidates by name - **Data Normalization** — employer names standardized, committee names cleaned, occupations categorized into industry groups - **Rich Stats** — aggregate metrics on donation totals, top donors, party breakdowns, and more ### 📊 Example Output ``` =========================================================================================== FEC CAMPAIGN FINANCE: INDIVIDUAL CONTRIBUTIONS =========================================================================================== Search: Tesla Retrieved: 50 contributions (of 14,892 total) Data source: api.open.fec.gov (Federal Election Commission) # Donor Amount Date Employer Committee ─── ──────────────────── ──────────── ──────────── ────────────────────── ──────────────────────── 1 Elon Musk $50,000.00 2025-03-15 Tesla Nrsc 2 Elon Musk $44,600.00 2024-06-30 Tesla Elon Musk Victory 3 Zachary Kirkhorn $5,800.00 2024-03-20 Tesla Nrcc ... ``` ### 🔧 Input Parameters | Parameter | Type | Description | Default | |---|---|---|---| | `searchType` | select | Search type: contributions, committees, or candidates | `contributions` | | `searchQuery` | string | **Required.** Search term (name, employer, committee) | — | | `contributorFilter` | select | (Contributions only) Field to search within | `All fields` | | `twoYearTransactionPeriod` | integer | Election cycle year (e.g. 2026 = 2025-2026) | `2026` | | `maxResults` | integer | Max results (1-500) | `100` | | `apiKey` | string | Optional data.gov API key for higher limits | `DEMO_KEY` | #### Example Input ```json { "searchType": "contributions", "searchQuery": "Tesla", "contributorFilter": "contributor_employer", "twoYearTransactionPeriod": 2026, "maxResults": 50 } ``` ### 🏷️ Data Normalization This actor goes beyond raw API passthrough: - **Employer names** — 40+ known companies mapped to canonical names (e.g. "GOOGLE INC" → "Google (Alphabet)") - **Committee names** — legal suffixes stripped, abbreviations standardized - **Occupation categorization** — free-text occupation mapped to 12 industry categories (Finance, Tech, Legal, Healthcare, etc.) - **Party/State expansion** — codes expanded to full names (e.g. "REP" → "Republican Party", "CA" → "California") - **Deduplication** — normalized names prevent duplicate entities ### 🎯 Use Cases - **Journalists** — investigate campaign finance patterns and donor networks - **Political campaigns** — research competitor fundraising - **NGOs & Watchdogs** — track money in politics - **Financial analysts** — monitor corporate political spending - **Researchers** — academic analysis of campaign contributions ### 📡 Data Source All data comes from the official [FEC API](https://api.open.fec.gov) provided by the US Federal Election Commission. The API is free and open — no registration required for basic use. For higher rate limits, register for a free data.gov API key. Data is updated regularly as committees file their reports with the FEC. ### 🚀 Quick Start 1. Enter a search query (company name, person, or committee) 2. Choose your search type and filters 3. Run the Actor — results appear in your dataset with normalized, clean data No API key needed — just search and go! # Actor input Schema ## `searchType` (type: `string`): What to search for. Contributions returns individual donor data, Committees returns PAC/campaign info, Candidates returns candidate filings. ## `searchQuery` (type: `string`): Search term. For contributions: contributor name, employer, or committee name. For committees: committee name. For candidates: candidate name. ## `contributorFilter` (type: `string`): (Contributions only) Which field to search within. ## `twoYearTransactionPeriod` (type: `integer`): Two-year election cycle (e.g. 2026 for 2025-2026 cycle). Default: current cycle. ## `maxResults` (type: `integer`): Maximum number of results to return (1-500). ## `apiKey` (type: `string`): Your data.gov API key for higher rate limits. Leave empty to use DEMO\_KEY (limited to ~1K requests/day). ## Actor input object example ```json { "searchType": "contributions", "searchQuery": "Tesla", "contributorFilter": "", "twoYearTransactionPeriod": 2026, "maxResults": 100, "apiKey": "" } ``` # Actor output Schema ## `results` (type: `string`): All normalized contribution, committee, or candidate records pushed to the default dataset. ## `summary` (type: `string`): Human-readable formatted table of results. ## `stats` (type: `string`): Machine-readable run statistics and summary metadata. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "Tesla" }; // Run the Actor and wait for it to finish const run = await client.actor("wakey7dev/fec-campaign-finance").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "Tesla" } # Run the Actor and wait for it to finish run = client.actor("wakey7dev/fec-campaign-finance").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "Tesla" }' | apify call wakey7dev/fec-campaign-finance --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=wakey7dev/fec-campaign-finance", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/v2CgKD0tFXfsEneSe/builds/TfwuWapDPVGBri9wh/openapi.json