AgorAPI (Agora Polling Interface) offers a set of services related to polls and votes through a public API. In other words, it is a web-service which may be queried by other computer programs or servers. AgorAPI provides simple access to complex voting methods (like Condorcet method, instant-runoff or majority judgement).
We recommend using ranked voting systems, however AgorAPI also allows to create usual polls (majority or approbation polling).
Set the text and the choices of a poll in a single request.
Add or remove choices during the whole poll lifetime, while preserving existing votes.
Use voters unique identifier to cast a vote, or to modify a vote later on.
Get a graphical, real time result for approbation (majority), instant runoff and Condorcet polls. Soon, AgorAPI will be enriched with other kinds of results like budget voting or majority judgement.
Manage your users, allow or forbid multiple choices, set up a veto system (the possibility to let a user remove a choice completely) or let choices be reformulated.
It is our API, but it is governed by your rules. The only limit is your creativity.
(*): This price corresponds to an annual subscription of $228 for premium and $1188 for enterprise. Monthly subscription, without minimal duration, costs $22 for premium and $114 for enterprise.
(**): Credits are the basic unit for counting queries to AgorAPI. Most simple read queries cost a single credit (GET). Write queries cost in general 10 credits (POST,DELETE,PATCH). Computation of the result also costs 10 credits. The actual cost of each individual query is specified in the interactive documentation. Only successful queries are taken into account. Furthermore, accessing the graphical charts does not cost any credit.
AgorAPI implements a RESTful API model conforming to industry best practices, making it straightforward to use. Exchanged data follow another web standard: json.
In order to jump into AgorAPI, we have written a starting guide. It may be the right place to start your interaction with AgorAPI.
We have published a basic set of PHP pages which interact with AgorAPI on a github repository. This is a simple open source web client for AgorAPI. Put these pages on a webserver and you may start using it. You are welcome to fork it and make it evolve with your contributions.