Getting election results

RSS/Atom feeds of results

There is an atom feed of recent election results available in two versions:

Here is an example of the former - this is the contents of the feed with additional extra elements with a single result:

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-gb">
  <title>Election results from Democracy Club Candidates (with extra data)</title>
  <link href="https://candidates.democracyclub.org.uk/" rel="alternate"/>
  <link href="https://candidates.democracyclub.org.uk/results/all.atom" rel="self"/>
  <id>https://candidates.democracyclub.org.uk/</id>
  <updated>2017-06-09T10:36:38.110335+00:00</updated>
  <entry>
    <title>David Cameron (Conservative and Unionist Party) won in Witney</title>
    <link href="https://candidates.democracyclub.org.uk/#32346" rel="alternate"/>
    <published>2017-06-09T10:36:38.110335+00:00</published>
    <updated>2017-06-09T10:36:38.110335+00:00</updated>
    <author>
      <name>joe</name>
    </author>
    <id>https://candidates.democracyclub.org.uk/#32346</id>
    <summary type="html">A Democracy Club Candidates volunteer recorded at 2017-06-09 10:36:38 that David Cameron (Conservative and Unionist Party) won the ballot in Witney, quoting the source 'BBC news'.</summary>
    <retraction>0</retraction>
    <election_slug>parl.2017-06-08</election_slug>
    <election_name>2017 General Election</election_name>
    <election_date>2017-06-08</election_date>
    <post_id>WMC:E14001046</post_id>
    <winner_person_id>566</winner_person_id>
    <winner_person_name>David Cameron</winner_person_name>
    <winner_party_id>party:52</winner_party_id>
    <winner_party_name>Conservative and Unionist Party</winner_party_name>
    <user_id>3</user_id>
    <post_name>Witney</post_name>
    <information_source>BBC news</information_source>
    <image_url>https://candidates.democracyclub.org.uk/media/images/5517d858249b917507bee4f8.png</image_url>
    <parlparse_id>uk.org.publicwhip/person/10777</parlparse_id>
  </entry>
</feed>

The corresponding basic Atom feed would look like:

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-gb">
  <title>Election results from Democracy Club Candidates (with extra data)</title>
  <link href="https://candidates.democracyclub.org.uk/" rel="alternate"/>
  <link href="https://candidates.democracyclub.org.uk/results/all.atom" rel="self"/>
  <id>https://candidates.democracyclub.org.uk/</id>
  <updated>2017-06-09T10:36:38.110335+00:00</updated>
  <entry>
    <title>David Cameron (Conservative and Unionist Party) won in Witney</title>
    <link href="https://candidates.democracyclub.org.uk/#32346" rel="alternate"/>
    <published>2017-06-09T10:36:38.110335+00:00</published>
    <updated>2017-06-09T10:36:38.110335+00:00</updated>
    <author>
      <name>joe</name>
    </author>
    <id>https://candidates.democracyclub.org.uk/#32346</id>
    <summary type="html">A Democracy Club Candidates volunteer recorded at 2017-06-09 10:36:38 that David Cameron (Conservative and Unionist Party) won the ballot in Witney, quoting the source 'BBC news'.</summary>
  </entry>
</feed>

If you're using this feed, please be aware that it's possible that a volunteer will record the wrong winner in error. In that case, there will be an entry in the feed to indicate that that statement about the winner has been retracted. If you're using the extended feed, that will have a <retraction>1</retraction> element. If you're using the basic feed, then the entry will look like:

<entry>
  <title>Correction: retracting the statement that Tessa Jowell (Labour Party) won in Dulwich and West Norwood</title>
  <link href="http://example.com/#32" rel="alternate"/>
  <published>2017-06-09T11:25:00.110335+00:00</published>
  <updated>2017-06-09T11:25:00.110335+00:00</updated>
  <author>
    <name>john</name>
  </author>
  <id>http://example.com/#32</id>
  <summary type="html">At 2017-06-09 11:25:00, a example.com volunteer retracted the previous assertion that Tessa Jowell (Labour Party) won the ballot in Dulwich and West Norwood, quoting the source 'Result recorded in error, retracting'.</summary>
</entry>

This feed contains results from any election, so if you just want to get results for the 2017 General Election, say, you should filter for <election_slug>parl.2017-06-08</election_slug>.

The additional XML elements in the extended feed have the following meaning:

election_slug
The election ID from Every Election which is also used in URLs that refer to the election on this site.
election_name
The human-readable name of this election
election_date
The date that the election is took place on
post_id
The ID of the post that the candidate has been elected to. In the case of the 2017 general election in the UK, for example, the post ID of WMC:E14001046 represents the UK parliament constituency of Witney, which has GSS code E14001046.
post_name
This is the human-readable short name of the post, which is typically the name of the constituency or area the candidate has been elected to represent, e.g. "Witney".
winner_person_id
The ID of the candidate who was elected to this post, which is used to identify them on this website (e.g. in URLs)
winner_person_name
The name of the candidate who was elected to this post.
winner_party_id
The ID of the party of the winning candidate. This is used in URLs on this website, and should be based on an official ID for the party. e.g. in the UK, party:52 is the Conservative party, which has ID 52 on the Electoral Commission's website.
image_url
If present, a link to a square headshot image of the candidate. (You can read about licensing of the photos on the About page.)
parlparse_id
If present, this means that the winning candidate has been previously elected, and this is their ID that's used on TheyWorkForYou, PublicWhip and parlparse.
user_id
The ID of the user of this site who recorded that this candidate was elected. This is unlikely to be of any use to you and will likely be removed in the future.
information_source
The source of information that this candidate was indeed elected to that post.

CSV/Excel downloads of election results

All Elected Candidates

This CSV file contains details of all candidates in the database who were elected at an election that this site covers.

Current Elections

There are no current elections.

Past Elections

There are no past elections.