State Legislators Scraper: Contacts & Committees (Open States)

Data source

Reads the public Open States openstates/people dataset on GitHub (official, CC0 licensed), which is updated by the Open States team as members and committees change.

What does State Legislators Scraper do?

It returns one clean record per US state legislator: name, state, chamber, district, party, official email, phone, capitol office address, committee seats with roles (chair, vice chair, member), photo, term start date and official websites. Filter by state, chamber, party or a keyword (name, district, city or committee), and pay per result returned.

Why use it?

• Build advocacy, lobbying and government relations contact lists for any set of states.
• Map who sits on which committee, and who chairs it, before a bill hearing.
• Keep a CRM or voter outreach tool in sync with current office holders by scheduling the Actor.
• Replace a manual copy from 50 legislature websites or a paid contact database.

How to use it

1. Open the Actor and set the filters.
2. Click Start. Download results as JSON, CSV or Excel, or read them through the API.
3. Add a Schedule and an Integration (Slack, Google Sheets, webhook) to get refreshed records automatically.

Input

Field	Description
states	Two letter state codes, for example wa, ca, ny. Default wa.
chamber	any, upper (Senate) or lower (House or Assembly).
party	Keep legislators whose party contains this text, for example democratic.
searchText	Keep legislators whose name, district, office address or committee names contain this text.
includeRetired	Also return former legislators (no committee data). Default off.
maxResults	Hard stop for the run. You are billed per result, so this caps the cost.
proxyConfiguration	Optional. Helps if GitHub rate limits your IP.

Example input:

{ "states": ["wa", "ny"], "chamber": "upper", "party": "democratic", "maxResults": 100 }

Output

Every record has the same shape (trimmed):

{
  "id": "ocd-person/9eddb3cd-868e-42ba-831a-b415fd7ed445",
  "name": "Adam Bernbaum",
  "state": "WA",
  "chamber": "lower",
  "chamberLabel": "House",
  "district": "24",
  "party": "Democratic",
  "email": "adam.bernbaum@leg.wa.gov",
  "phone": "360-786-7916",
  "capitolAddress": "Room 418, John L. O'Brien Building P.O. Box 40600, Olympia, WA 98504",
  "committees": [
    { "name": "Transportation", "role": "vice chair", "chamber": "lower" }
  ],
  "isCurrent": true,
  "photoUrl": "https://leg.wa.gov/memberphoto/34240.jpg",
  "termStart": "2024-12-06",
  "websites": ["https://leg.wa.gov/legislators/member/adam-bernbaum"],
  "scrapedAt": "2026-10-09T08:37:39.377Z"
}

Field	Meaning
id	Open States person ID, stable and safe for deduplication between runs
chamber / chamberLabel	upper or lower, and Senate or House
committees	Committee name, role and chamber for each seat
districtOfficePhone, districtOfficeAddress	District office details when published
termStart, termEnd	ISO dates from the current role

Pricing

Pay per event: a small fee when a run starts, then a fixed price per result returned. You only pay for records that pass your filters. Set maxResults to cap any run.

Limitations

• Covers legislators and committees only. Bills and votes are not included: the Open States bill API and website require an account or a bot check, so they are not read.
• Committee data is only as complete as the Open States people dataset for that state, and some states list few or no committees.
• Each state costs one GitHub API request, limited to 60 per hour per IP. Use the proxy option for very large multi state runs.
• Data comes from the dataset as published, so it can lag a special election or resignation by days.

FAQ

Is this legal? The Actor reads a public dataset released under CC0 and stores only the official contact details legislators publish for their public offices. You are responsible for how you use the data.

Something is missing or broken? Open an issue in the Issues tab; response time is usually under a day.