---
title: "Site semantics for a landing page (Wordstat) — 49 ₽ quick / 149 ₽ deep"
method: POST
path: "/semantics"
tags: ["Campaigns"]
---

# Site semantics for a landing page (Wordstat) — 49 ₽ quick / 149 ₽ deep

`POST /semantics`

## Request

- Base URL: `https://vibemarketolog.ru/api/agent`
- URL: `https://vibemarketolog.ru/api/agent/semantics`
- Auth: HTTP bearer

Keywords from Yandex Wordstat grouped by landing-page blocks (hero, pricing, faq, lead_form…), with frequency, negative words and, for deep, 24-month seasonality and A/B headlines per cluster. dry_run=true returns the price without charging. Same idempotency_key replays the previous answer without a second charge. Wordstat unavailable → 503 wordstat_unavailable (full refund); no phrases → 422 no_phrases (full refund). MCP twin: build_semantics.

## Request body

- object
  - `topic` string: What is sold and where, e.g. "кухни на заказ в Казани"
  - `seeds` string[]
  - `depth` 'quick' | 'deep'
  - `region_ids` integer[]: Yandex region ids: 213 Moscow, 2 St Petersburg, 43 Kazan
  - `negative_words` string[]
  - `ab_headlines` boolean
  - `dry_run` boolean
  - `idempotency_key` string

## Response `200`

keywords[], clusters[] {name, block, intent, head, freq_sum, phrases[], headline_a?, headline_b?}, negative_suggestions[], seasonality[] (deep), cost, balance_after

- object

## Other responses

- `401`: Ключ не передан, недействителен, отозван или истёк (missing_token / invalid_token)
- `402`: insufficient_balance / email_confirmation_required
- `403`: У ключа нет нужного права либо адрес запроса не в списке разрешённых (insufficient_scope / ip_not_allowed)
- `422`: Поля запроса не прошли проверку; разбор — в details (validation_failed)
- `429`: Превышена частота запросов или суточный лимит траты ключа (rate_limit_exceeded / daily_spend_limit_exceeded)
- `500`: Внутренняя ошибка сервиса; повторите позже и сообщите request_id (internal_error)
- `503`: wordstat_unavailable — full refund

---

[API](https://skmtc.dev/vibemarketolog/apis/agent-api.md) · [All operations](https://skmtc.dev/vibemarketolog/apis/agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vibemarketolog/apis/agent-api/revisions/6a74f8ad5d58?raw)