# API та MCP-сервер YOOtraffic

> Публічний API YOOtraffic лише для читання, MCP-сервер через Streamable HTTP і markdown-версія кожної сторінки. Без ключа та реєстрації.

Усе, що публікує цей сайт, доступне програмам так само, як людям: JSON API лише для читання, MCP-сервер і markdown-подання кожної сторінки. Без ключа, без реєстрації, без лімітів понад звичайний захист від зловживань.

## YOOtraffic Content API

Публічний REST API до каталогу продуктів, моделі цін, переліку сторінок, тексту сторінок і блогу. Він відповідає на питання про продукт. Він не замовляє трафік і не керує кампанією: це робиться в особистому кабінеті й через цей API недоступне.

Базовий URL

Специфікація OpenAPI 3.1

Авторизація

Не потрібна. Усі ендпоінти публічні, лише для читання та відкриті для запитів з будь-яких доменів (CORS).

Формат відповіді

JSON, UTF-8, кешується на CDN на п'ять хвилин.

## Ендпоінти

Перелік формується з документа OpenAPI, тому він не може розійтися зі специфікацією.

## Швидкий старт

Три запити покривають майже все, що потрібно агенту: що продається, скільки коштує і що написано на сторінці.

## MCP-сервер

Ті самі операції у вигляді MCP-інструментів через транспорт Streamable HTTP. Вкажіть будь-якому MCP-клієнту адресу нижче. Кроку авторизації немає, сесія не зберігається: кожен інструмент лише читає.

Адреса

Транспорт

Streamable HTTP (POST, JSON-RPC 2.0)

Маніфест сервера

Конфігурація клієнта

Інструменти

## Markdown для кожної сторінки

Кожна сторінка віддається не лише як HTML, а й як markdown, тому краулеру не треба розбирати верстку, щоб прочитати текст.

- Надішліть Accept: text/markdown на будь-яку адресу сторінки і отримайте її ж у markdown.
- Або додайте .md до шляху: https://yootraffic.com/uk/pricing.md
- У відповідях є Vary: Accept і заголовок Link із посиланням на markdown-версію.
- Якщо заголовок Accept відкидає обидва подання, сервер відповідає 406 і не намагається вгадати формат.
- Неіснуючий шлях віддає справжній 404 з markdown-тілом, де перелічено, куди йти далі.

## Машиночитані файли

- Специфікація OpenAPI: https://yootraffic.com/openapi.json
- Маніфест MCP-сервера: https://yootraffic.com/mcp.json
- Опис сайту для мовних моделей: https://yootraffic.com/llms.txt
- Ціни в markdown: https://yootraffic.com/pricing.md
- Карта сайту: https://yootraffic.com/sitemap.xml
- Правила для краулерів: https://yootraffic.com/robots.txt

## Питання

Пишіть на support@yootraffic.com. Якщо в API бракує чогось потрібного, розкажіть, що ви робите, і ми подивимось, чи можна це додати.

## Endpoints

- `GET /api/v1` (getServiceIndex): Describe the API
- `GET /api/v1/products` (listProducts): List products
- `GET /api/v1/products/{productId}` (getProduct): Get one product
- `GET /api/v1/pricing` (getPricing): Get the pricing model
- `GET /api/v1/pages` (listPages): List public pages
- `GET /api/v1/content` (getPageContent): Get a page as markdown
- `GET /api/v1/posts` (listBlogPosts): List blog posts
- `GET /api/v1/search` (searchSite): Search pages and posts

## MCP tools

- `list_products`: List every YOOtraffic product with its traffic type, billing unit, entry price, and what is included. Use this to answer what the company sells.
- `get_pricing`: Unit prices for every product plus the account terms (minimum deposit, refunds, balance expiry) and an explicit list of what the service does not deliver. Prices are USD, pay-as-you-go, no subscription. Call this instead of quoting a price from memory.
- `list_pages`: The index of every public page with its title, description, URL, and markdown URL. Use it to find the page that answers a question before fetching its text.
- `get_page_content`: The full text of any public page as markdown, including blog posts and legal documents. Give a site path such as /en/pricing or /en/blog/some-post.
- `list_blog_posts`: Published articles, newest first, with title, excerpt, date, and markdown URL.
- `search_site`: Search page titles, page descriptions, and article titles and excerpts. Returns URLs and markdown URLs so the matching text can be fetched directly.

---

- HTML version of this page: https://yootraffic.com/uk/developers
- Site index for agents: https://yootraffic.com/llms.txt
- Sitemap: https://yootraffic.com/sitemap.xml