# Atly Places API

> Atly scores close to 2 million places against more than 1,400 specific intents — "work friendly",
> "gluten free", "great cappuccino", "dog friendly" — from what real reviewers say, and keeps the
> short statements behind every score. Coverage is densest in the United States, with pockets in
> Mexico, Israel and Thailand.

This host is the API itself. If you are an agent, start with the guide: it is written for you.

## Start here

- [Guide for agents](https://agentic-api.atly.com/v2/docs): the workflow, the shapes, and the rules. Also `get_docs` over MCP.
- [OpenAPI contract](https://agentic-api.atly.com/v2/openapi.yaml): every operation, machine-readable.
- MCP endpoint: `https://agentic-api.atly.com/mcp` (Streamable HTTP). Open it in a browser for connection instructions.

API v1 was retired on 2026-10-26: this address and every /v0 link now serve v2 (/v0 redirects to /v2).

## How a question gets answered

Map the user's words to categories with `list_categories`, resolve a place name with `list_areas`
(or pass `lat`/`lon`/`radius_km`), then `search_places`, and `get_place` for depth. Every response
carries a `call_id`; `submit_feedback` tells us how it went.

## Access

No key is needed to start; anonymous callers share a small hourly quota per IP. `POST https://agentic-api.atly.com/v2/keys`
with an email returns a key with a daily quota — send it as `X-API-Key` — and verifying that email
raises it. Chat connectors use OAuth instead and need no key.

## About

Built by Atly (Steps Solutions Ltd.).

- Atly: https://www.atly.com
- Privacy: https://www.atly.com/privacy
- Terms: https://www.atly.com/terms
- Contact: info@atly.com