--- type: "firecrawl-provider" description: "Search FEC candidates for federal office (House, Senate, President) by name, ID, office, state, party, district or election year. Each row is one FEC candidate ID with party, incumbency, status, the cycles it is active in and its principal campaign committees." use_when: "Find a federal candidate's FEC candidate ID and principal campaign committee before asking for totals, filings or independent expenditures." credits_per_call: 0 options: 12 --- # FEC: Candidates Search FEC candidates for federal office (House, Senate, President) by name, ID, office, state, party, district or election year. Each row is one FEC candidate ID with party, incumbency, status, the cycles it is active in and its principal campaign committees. ## Agent instructions Find a federal candidate's FEC candidate ID and principal campaign committee before asking for totals, filings or independent expenditures. - Category file: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider file: [Provider guide](https://firecrawl.dev/alexandria/agents/providers/fec-gov) - Provider key: `fec-gov` - Capability: `records/candidates` - Cost: 0 credits per call ## Request options - `candidate_id` (string): FEC candidate ID, e.g. S2MA00170 (H House, S Senate, P President). Pattern: ^[HSPhsp][0-9A-Za-z]{8}$. Example: `` - `cycle` (number): Cycle in which the candidate was active, named by its even year: 2024 covers 2023-2024. Example: `1976` - `district` (string): House district, two digits (00 at-large). Pattern: ^[0-9]{2}$. Example: `` - `election_year` (number): Year of an election the candidate ran in. Example: `1976` - `has_raised_funds` (boolean): Only candidates whose committees reported receipts. Example: `false` - `is_active_candidate` (boolean): is_active_candidate Example: `false` - `office` (string): H House, S Senate, P President. Example: `H` - `page` (number): 1-based page; pass the previous next_page with the same filters. Example: `1` - `party` (string): Three-letter FEC party code, e.g. DEM, REP, LIB, GRE, IND. Pattern: ^[A-Za-z0-9]{3}$. Example: `` - `per_page` (number): Rows per page, 1 to 100. Example: `10` - `query` (string): Name search, e.g. warren. Pattern: \S. Example: `` - `state` (string): Two-letter US state or territory code, e.g. MA. Pattern: ^[A-Za-z]{2}$. Example: `` ## Request shape Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: }` and your Firecrawl API key. ```json { "provider": "fec-gov", "capability": "records/candidates", "options": { "candidate_id": "S2MA00170" } } ``` ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "fec-gov", capability: "records/candidates", options: { candidate_id: "S2MA00170", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "fec-gov", "capability": "records/candidates", "options": { "candidate_id": "S2MA00170" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "fec-gov", "capability": "records/candidates", "options": { "candidate_id": "S2MA00170" } } }' ``` ### CLI ```sh firecrawl scrape 'fec-gov/records/candidates' \ --options '{"candidate_id":"S2MA00170"}' ``` ## Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. These fields and the example below describe the provider payload in `data`. ```json { "count_is_exact": true, "next_page": null, "observed_at_ms": 1791423237000, "page": 1, "per_page": 10, "records": [ { "active_through": 2030, "candidate_id": "S2MA00170", "candidate_inactive": false, "candidate_status": "C", "cycles": [ 2012, 2014, 2016, 2018, 2020, 2022, 2024, 2026 ], "district": "00", "district_number": 0, "election_districts": [ "00", "00", "00", "00" ], "election_years": [ 2012, 2018, 2024, 2030 ], "fec_url": "https://www.fec.gov/data/candidate/S2MA00170/", "federal_funds_flag": false, "first_file_date": "2011-08-19", "has_raised_funds": true, "inactive_election_years": null, "incumbent_challenge": "I", "incumbent_challenge_full": "Incumbent", "last_f2_date": "2025-08-26", "last_file_date": "2025-08-26", "load_date": "2025-08-26T21:03:22", "name": "WARREN, ELIZABETH", "office": "S", "office_full": "Senate", "party": "DEM", "party_full": "DEMOCRATIC PARTY", "principal_committees": [ { "affiliated_committee_name": "MASSACHUSETTS SENATE VICTORY 2024", "candidate_ids": [ "S2MA00170" ], "committee_id": "C00500843", "committee_type": "S", "committee_type_full": "Senate", "cycles": [ 2012, 2014, 2016, 2018, 2020, 2022, 2024, 2026 ], "designated_agent_city": null, "designated_agent_first_name": null, "designated_agent_last_name": null, "designated_agent_middle_name": null, "designated_agent_name": null, "designated_agent_phone_number": null, "designated_agent_prefix": null, "designated_agent_state": null, "designated_agent_street1": null, "designated_agent_street2": null, "designated_agent_suffix": null, "designated_agent_title": null, "designated_agent_zip": null, "designation": "P", "designation_full": "Principal campaign committee", "filing_frequency": "Q", "first_f1_date": "2011-08-18", "first_file_date": "2011-08-18", "last_f1_date": "2025-08-26", "last_file_date": "2026-07-15", "name": "WARREN FOR SENATE, INC.", "organization_type": null, "organization_type_full": null, "party": "DEM", "party_full": "DEMOCRATIC PARTY", "state": "MA", "treasurer_name": "EGERMAN, PAUL" } ], "state": "MA" } ], "source_url": "https://api.open.fec.gov/v1/candidates/search/?candidate_id=S2MA00170&sort=name&page=1&per_page=10", "total_count": 1, "total_pages": 1 } ``` ## Explore other popular capabilities If this capability is not the best match, fetch only the relevant capability file: - [Committee totals](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/committee_totals): Financial totals for one FEC committee per two-year cycle, summed from its F3, F3P or F3X reports: receipts, contributions (individual itemized and unitemized, PAC, party, candidate), loans, transfers, disbursements, operating expenditures, independent expenditures, cash on hand and debts, with the coverage dates of the latest report. Newest cycle first. - [Committees](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/committees): Search FEC-registered committees: candidate campaign committees, PACs, super PACs, hybrid PACs and party committees. Filter by name, committee ID, linked candidate, committee type, designation, state, party or cycle. Rows carry type, designation, treasurer, linked candidate IDs and active cycles. - [Disbursements](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/disbursements): Itemized disbursements (FEC Schedule B): who a committee paid, how much, when and for what (purpose, category, report line), newest first or by amount. Filter by spending committee, recipient name or committee, recipient state, purpose category, transaction period, date and amount ranges. Contribution refunds to individuals (lines 20a/28a) are withheld because they name individual contributors. - [Filings](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/filings): Reports and statements filed with the FEC (F3/F3P/F3X financial reports, F24/F5 independent-expenditure reports, F1/F2 registrations and others), newest receipt first. Filter by committee, candidate, filer name, form, report type, report year, cycle, receipt date range or most-recent version. Rows include coverage dates, summary totals, amendment state and links to the filed PDF, HTML, .fec and CSV. - [Independent expenditures](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/independent_expenditures): Independent expenditures (FEC Schedule E): spending by super PACs, PACs, parties and others expressly for or against a federal candidate, with spender, candidate, support or oppose, amount, expenditure and dissemination dates, payee and purpose. Filter by spender, candidate, support/oppose, cycle, candidate office/state/party, payee, date and amount ranges; newest first or by amount.