# 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.

Source: https://citypicked.com/en/developers

## 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.

## Three ways in

- [MCP](https://citypicked.com/en/developers/mcp): Connect Claude, ChatGPT, Claude Code or Cursor. Your assistant sends and reads in plain language.
- [REST API](https://citypicked.com/en/developers/api): JSON over HTTPS with an API key. Every endpoint with examples in curl, JavaScript and Python.
- [CLI](https://citypicked.com/en/developers/cli): Requests, links, feedback and numbers from the terminal and from scripts.

## Addresses

| 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](https://api.citypicked.com/v1/openapi.json) |

## Where to start

1. Follow the [quickstart](https://citypicked.com/en/developers/quickstart). Make a key, make a first call, send one request, read the result.
2. Read how [keys and scopes](https://citypicked.com/en/developers/authentication) work.
3. Look up any endpoint in the [API reference](https://citypicked.com/en/developers/api).

## Machine-readable

- The [OpenAPI 3.1 document](https://api.citypicked.com/v1/openapi.json) 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](https://citypicked.com/llms.txt) and [llms-full.txt](https://citypicked.com/llms-full.txt) list the pages for AI assistants