citizenscount.org APIcitizenscount.org ↗
Access NH candidate profiles, election results, bill details, elected officials by town, and policy topics via the Citizens Count API. 15 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b478096f-c6b1-4653-9c31-f53541f97170/get_candidate_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full A-Z list of candidate and officeholder profiles from Citizens Count NH. Returns all candidates with their names, slugs, and profile URLs.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total number of candidates",
"candidates": "array of candidate objects with name, slug, and url"
},
"sample": {
"data": {
"total": 3625,
"candidates": [
{
"url": "https://www.citizenscount.org/candidate/kimberly-abare",
"name": "Kimberly Abare",
"slug": "kimberly-abare"
}
]
},
"status": "success"
}
}About the citizenscount.org API
The Citizens Count NH API exposes 15 endpoints covering New Hampshire political data: candidate profiles with party affiliation and policy positions, election results with vote counts, NH bill summaries and full details, and elected officials filtered by town. The get_elected_officials_by_town endpoint alone returns federal, state, and local representatives for any of the hundreds of NH towns and wards in the index.
Candidate and Officeholder Data
The get_candidate_list endpoint returns the full A-Z index of candidate and officeholder profiles as an array of objects with name, slug, and url. Pass any slug (e.g. 'kelly-ayotte') to get_candidate_profile to retrieve party, current_office, and a positions array where each item includes issue, stance, and a text description. This makes it straightforward to build candidate comparison tools or policy-position trackers without manually crawling individual profile pages.
Elections and Legislative Tracking
get_elections_list returns all tracked elections with their slugs, which you then pass to get_election_results to get a results array containing race, candidate, party, votes, and percentage per row. On the legislative side, get_bills_list supports optional page (0-indexed) and topic parameters so you can paginate through all NH bills or filter to a specific policy area like 'guns' or 'marijuana'. The topic slugs themselves come from get_topics_list. get_bill_detail returns the full title, status, sponsor, summary, and description for any individual bill.
Geo-Filtered Officials and Town Index
get_nh_towns_list returns every NH town, city, and ward with a slug in county/town format (e.g. 'rockingham/auburn'). Feed that slug to get_elected_officials_by_town and the response includes a representatives array with name, slug, and office for all levels of government serving that location. get_elected_officials provides a category-level overview (US President, NH Governor, US Senate, etc.) with links to detail pages.
Search, Articles, and Voter Guides
search_site accepts a free-text query and returns title, url, and snippet for matching content across candidates, bills, and news. get_articles_list paginates through discussion topics and news stories; get_article_detail returns the full content, date, and title for any article by its path slug (prefixed with /news/ or /issues/). get_voter_information returns structured voter education articles with titles and URLs.
- Build a candidate comparison tool that pulls policy positions from
get_candidate_profileacross multiple candidates on the same issue. - Display all state and federal representatives for a user's NH town using
get_elected_officials_by_townwith a town slug fromget_nh_towns_list. - Track New Hampshire legislation by topic using
get_bills_listfiltered with atopicslug, then pull full bill text viaget_bill_detail. - Populate election results dashboards using vote counts and percentages from
get_election_resultsfor specific NH races. - Aggregate policy topic content and related bills using
get_topic_detailto feed a civic education or news briefing app. - Power a full-text search feature over NH political content using
search_sitewith keyword queries. - Archive NH political news and issue articles by paginating
get_articles_listand fetching full text withget_article_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Citizens Count have an official developer API?+
What does `get_candidate_profile` return beyond basic biographical data?+
party, current_office (if the candidate holds one), and a positions array. Each position object includes the issue, the candidate's stance, and a text description. It does not include voting history or campaign finance figures.Does the API cover states other than New Hampshire?+
Does `get_election_results` include historical results going back many election cycles?+
get_elections_list index. Coverage depth depends on what Citizens Count has published; very old cycles may not appear. You can fork the API on Parse and revise it to target archived election pages if you need results beyond what the index surfaces.How does pagination work for `get_bills_list` and `get_articles_list`?+
page integer parameter that is 0-indexed, so page 0 is the first page. Neither endpoint returns a total page count in the response, so you should continue incrementing page until you receive an empty array to know you have reached the end.