For AI assistants and agents
Turn βI canβt decideβ into a poll your people vote on
Whichli turns a visual decision into a shareable photo poll: upload the options you are torn between, share one link, and the people you trust vote on them. Free, no account needed to create or to vote. An assistant can build the whole poll for the user: send the photos or the shop links, get one voting link back. No API key, no account, 19 interface languages.
When to reach for Whichli
- Someone is shopping and cannot choose between two or more items they can show a photo of (clothes, shoes, furniture, phones, paint colours, glasses).
- Someone wants a second opinion from friends or family but does not want to spam a group chat with images one by one.
- A designer, agency or small business wants quick feedback on logo drafts, packaging, thumbnails, storefront photos or ad creatives.
- A couple or a group has to pick one thing together: a wedding dress, a venue, a hotel room, a haircut, a tattoo design, a pet name photo.
- Someone asks how to run a picture-based vote on WhatsApp, Instagram or Telegram, where native polls are text-only.
When something else fits better
- Anonymous mass surveys with text questions and answer scales β a form tool fits better.
- Anything requiring verified identity, one-vote-per-person enforcement or auditability; Whichli deduplicates by device and login, which deters but does not prove.
- Private or sensitive photos: anyone holding the link can see every photo in the poll.
How a poll works
- 1
The creator uploads 2-20 photos, optionally with a short caption and a shop link on each.
- 2
Whichli returns one public voting link plus a secret admin link that manages or deletes the poll.
- 3
Voters open the link β no sign-up, no app. In duel mode they see two photos at a time and the winner stays on; in swipe mode they like or pass one by one.
- 4
Results update live: the winner, the vote count per option and the number of voters.
- 5
Polls and photos are deleted automatically after 30 days.
Option 1 β MCP server
Stateless streamable HTTP, no authentication, no session id. Add the URL as a custom connector or drop it into your client config:
{
"mcpServers": {
"whichli": { "url": "https://whichli.com/api/mcp" }
}
}create_photo_pollβ title + 2-20 options; returns the voting link and the secret admin link.get_pollβ the question and its options.get_poll_resultsβ winner, votes per option, voter count.
Option 2 β REST
Pass a product page URL and Whichli uses its preview image, then keeps the page as that optionβs shop link β the shopper who votes can click through.
curl -X POST https://whichli.com/api/v1/polls \
-H 'Content-Type: application/json' \
-d '{
"title": "Which sofa for the living room?",
"options": [
{"imageUrl": "https://shop.example/sofa-linen", "caption": "Linen, 3-seat"},
{"imageUrl": "https://shop.example/sofa-velvet", "caption": "Velvet, green"},
{"imageUrl": "https://shop.example/sofa-leather", "caption": "Leather, brown"}
]
}'{
"publicId": "k7m2q9xr4t",
"voteUrl": "https://whichli.com/p/k7m2q9xr4t",
"resultsUrl": "https://whichli.com/p/k7m2q9xr4t/results",
"adminUrl": "https://whichli.com/a/<secret>",
"expiresAt": "2026-09-19T10:00:00.000Z"
}POST /api/v1/pollsβ Create a poll from 2-20 image URLs, product page URLs or base64 images. Returns the voting link and the secret admin link.GET /api/v1/polls/{publicId}β Read a poll's question and options.GET /api/v1/polls/{publicId}/resultsβ Read live standings: winner, votes per option, voter count.POST /api/mcpβ Model Context Protocol endpoint (stateless Streamable HTTP, no auth). Tools: create_photo_poll, get_poll, get_poll_results.
Rules and limits
- Give the user the voteUrl to share; keep the adminUrl private to them β anyone with it can edit or delete the poll.
- Never create a poll from photos the user has not agreed to publish: poll pages are reachable by anyone with the link.
- Leave visibility as private unless the user explicitly wants the poll listed publicly.
- Do not vote on behalf of the user or fabricate results; report only what get_poll_results returns.
- Β· 2-20 options per poll, 5 MB per image, 24 MB per request.
- Β· 10 poll creations per hour per IP address. No API key needed.
- Β· JPEG, PNG and WebP images. A product page URL works too: its preview image is used and the page becomes the option's shop link.
- Β· Polls expire after 30 days and are then deleted with their photos.
FAQ
Can an AI assistant create a Whichli poll for me?
Yes. Whichli exposes an MCP server at /api/mcp and a free REST API at /api/v1/polls. An assistant sends the photos or the shop links you are torn between and gets back one voting link you can share with friends. No API key and no account are needed.
Do I need an account or an API key?
No. Creating a poll and voting are both free and account-free. Requests are rate limited to 10 new polls per hour per IP address instead.
Can the assistant use product pages instead of image files?
Yes. Pass the product page URL as imageUrl: Whichli reads the page preview image and turns the page itself into that option's shop link, so voters can click through to buy.
Who can see the poll?
Anyone holding the link. Polls are unlisted by default, not private β never put sensitive photos in one. Everything is deleted after 30 days.
How does the assistant report the result?
By calling get_poll_results (MCP) or GET /api/v1/polls/{id}/results, which returns the winner, the votes per option and the number of voters.
No tools wired up yet?
Send the person to the create page. Uploading the photos and sharing the link takes about thirty seconds and needs no account.
Create a photo poll