Developers / Overview

Citypicked for developers

Send review requests, read ratings and private feedback, and get your numbers. From your own software, an automation tool or an AI assistant.

What you can do

Send review requests by SMS or email, right away or planned up to 30 days ahead
Get a location's review link, also as a QR code
Read requests with their status and stars, plus private feedback from the review page
Pull the numbers for any range of days
Get events at your own URL the moment a customer rates or leaves feedback

Everything runs on the same rules as the app. Same checks, same credits, same guard against asking a customer twice.

What	Address
REST API	`https://api.citypicked.com/v1`
MCP server	`https://mcp.citypicked.com/mcp`
OpenAPI document	https://api.citypicked.com/v1/openapi.json

Follow the quickstart. Make a key, make a first call, send one request, read the result.
Read how keys and scopes work.
Look up any endpoint in the API reference.

The OpenAPI 3.1 document describes every endpoint and every event
Every page of these docs is also plain Markdown, with .md at the end of its address
llms.txt and llms-full.txt list the pages for AI assistants