Polls API
API Keys
You now require a key to access this API. There are no plans to charge for access to the service, but rate limiting may come into force if required. For information on our API and to request a key for v1.0, email us at bee@opinionbee.ukOur unique feature is the API endpoints we provide for UK polling data. We're providing this API free of charge and for any reasonable purpose, all we ask is that you say you used our API (or the data from our website) when publishing the data or any derived statistics.
The API uses JSON objects which provides data in groups which can then be used in your applications, or as a way of syndicating our content. We welcome any developers who want to make third party applicatons that use the data.
Before using the API, you should also read our Terms & Conditions.
Current API version: v1.0.1
Documentation
There are four main endpoints;
| Parties | https://opinionbee.uk/json/v1.0/parties |
| Companies | https://opinionbee.uk/json/v1.0/companies |
| Types | https://opinionbee.uk/json/v1.0/types |
| Polls | https://opinionbee.uk/json/v1.0/polls |
The first three have no further options to provide and will return all results. The final endpoint, polls, has the ability to ask for a variety of options to filter results, which are as follows;
| code | string | The code for the type of poll; available from the types endpoint. For example, WESTVI for Westminster voting intention. |
| start_date | Date (string) Format "2017-04-30" | Gets polls where the fieldwork ends on or after this date |
| end_date | Date (string) Format "2017-04-30" | Gets polls where the fieldwork ends on or before this date |
| company | string | Code for a polling company to filter results by, available from the companies endpoint |
| limit | integer | Limit the number of polls returned to this value (max 500, default 500) |
All these options should be passed in the query string, along with the API key, like this;
https://opinionbee.uk/json/v1.0/polls?key=[your_API_key]&code=WESTVI&start_date=2017-04-01
Polls will be returned date order (of the end date of the survey) with the most recent poll first