Open Quick Poll API

Quick Poll Maker

This documentation explains how to use the dynamic generation functionality of the Quick Poll Maker, a lightweight endpoint designed to quickly generate public polls via URL parameters. It allows you to create multiple types of polls with no integration into user accounts or existing systems on Polling.com.

The endpoint does not require an account, API key, or any setup. It is completely free and open. It is designed to be as frictionless as possible.

Note: This is a standalone endpoint that does not integrate with user accounts or the broader Polling.com Services. It comes with limitations - it is limited in question types and limited to a single question. Results of the poll also are public with no option for private results. A poll does not have an "owner".

Features

• Multiple poll types: Supports radio (multiple choice), checkbox, ranking, short text input, and star ratings.
• Dynamic poll creation: Polls can be generated dynamically by passing parameters like question title, description, and answer options.
• Standalone service: This service operates independently from user accounts and the larger Polling API.

How It Works

You can generate a poll by constructing a URL with the following query parameters:

Poll URL Parameters

• qTitle: The title of your poll question (required).
• qDesc: A description providing additional context for the poll (optional).
• type: The type of question, which can be one of the following:
  • radio (multiple choice)
  • checkbox (checkbox options)
  • ranking (ranked options)
  • text (single line text input)
  • rating (star rating)
• a: One or more answer options. This parameter is repeatable and only applies to radio, checkbox, and ranking types.

Example Poll URLs

Multiple Choice Poll (Radio)

https://app.polling.com/quick-poll?qTitle=What%27s+your+favorite+color&type=radio&a=Red&a=Blue&a=Green

Checkbox Poll

https://app.polling.com/quick-poll?qTitle=Which+fruits+do+you+like&type=checkbox&a=Apple&a=Banana&a=Orange

Star Rating Poll

https://app.polling.com/quick-poll?qTitle=How+would+you+rate+this+product&type=rating

Programmatic Poll Creation

Polls can be created programmatically allowing you to dynamically generate poll URLs based on user input or other logic.
Programmatic poll creation isn't limited to any specific programming language however the below examples in PHP and Javascript are provided to help explain how it works.
Using Programmatic Poll Creation by constructing this URL makes running many polls (even hundreds) on a website or app as frictionless as possible.

JavaScript Example

const baseUrl = 'https://app.polling.com/quick-poll';
let query = new URLSearchParams({
    qTitle: "What's your favorite color?",
    qDesc: "Select the color that best fits your personality.",
    type: "radio"
});
const options = ["Red", "Blue", "Green"];
options.forEach(option => {
    query.append('a', option);
});
const finalUrl = `${baseUrl}?${query.toString()}`;
console.log(finalUrl);

PHP Example

$baseUrl = 'https://app.polling.com/quick-poll';
$query = http_build_query([
    'qTitle' => "What's your favorite color?",
    'qDesc' => "Select the color that best fits your personality.",
    'type' => 'radio'
]);
$options = ["Red", "Blue", "Green"];
foreach ($options as $option) {
    $query .= "&a=" . urlencode($option);
}
echo "{$baseUrl}?{$query}";

OpenAPI v3 YAML

For use by LLMs and third party software we provide an OpenAPI spec at https://polling.com/openapi.yaml

Quick Poll Maker UI

If you're not familiar with programming or just want a fast and easy way to create a poll, use our Free Poll Maker for a user-friendly interface to generate quick polls without coding.

This quick poll generation service is a fast and simple tool for creating single polls without requiring account integration or registration. For more advanced features, please explore our full featured offerings at Polling.com.