SEO Dash API

Публичный SEO-API: классификаторы, Firecrawl, Ahrefs, DataForSEO, keys.so, Mutagen, подбор доноров, LLM, PageSpeed, индексация, парсинг выдачи. Интерактивная схема — /docs · OpenAPI — /openapi.json

1. Регистрация и ключ

Саморегистрация открыта. После регистрации подтвердите e-mail по ссылке из письма, затем создайте API-ключ.

# 1) Регистрация (придёт письмо со ссылкой подтверждения)
curl -X POST https://api.seodash.top/v1/auth/register \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","password":"your-strong-pass"}'

# 2) Перейдите по ссылке из письма (GET /v1/auth/confirm?token=...)

# 3) Создайте ключ (показывается ОДИН раз)
curl -X POST https://api.seodash.top/v1/keys \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","password":"your-strong-pass","name":"prod"}'
# → {"api_key":"sk_live_...","prefix":"sk_live_ab12"}

2. Аутентификация

Передавайте ключ в заголовке Authorization: Bearer <key> (или X-Api-Key: <key>).

curl https://api.seodash.top/v1/account -H 'Authorization: Bearer sk_live_...'

3. Баланс и пополнение

Биллинг — собственный баланс в рублях. Пополнение: Robokassa или крипта (CryptoCloud). Зачисление происходит после оплаты (автоматически в течение ~минуты; можно проверить вручную).

# Создать счёт на пополнение
curl -X POST https://api.seodash.top/v1/billing/topup \
  -H 'Authorization: Bearer sk_live_...' -H 'Content-Type: application/json' \
  -d '{"amount_rub":500,"provider":"robokassa"}'
# → {"invid":123456789,"pay_url":"https://auth.robokassa.ru/...","status":"pending"}

# Оплатить по pay_url, затем проверить:
curl -X POST https://api.seodash.top/v1/billing/check/123456789 -H 'Authorization: Bearer sk_live_...'

4. Бесплатный тир

5 бесплатных запросов на каждый эндпоинт на аккаунт — кроме Ahrefs и DataForSEO (у них бесплатных нет). Дальше — списание с баланса. Остаток бесплатных — в GET /v1/account (поле free_left).

5. Одиночные и пакетные запросы

Каждый эндпоинт принимает одиночный запрос (поля прямо в теле) или пакет до 100 элементов через поле items. В пакете каждый элемент тарифицируется отдельно; ошибка одного элемента не валит остальные.

# Одиночный
curl -X POST https://api.seodash.top/v1/commerce -H 'Authorization: Bearer sk_live_...' \
  -H 'Content-Type: application/json' -d '{"domain":"example.com"}'

# Пакет (до 100)
curl -X POST https://api.seodash.top/v1/ahrefs-dr -H 'Authorization: Bearer sk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"domain":"a.com"},{"domain":"b.com"}]}'

Ответ содержит cost: режим (free/charge), списано ₽, остаток баланса.

6. Эндпоинты

POST /v1/commerce 5 бесплатно

Классификатор коммерческости

Параметры: text ИЛИ domain/url
Возвращает: type, confidence, type_ru

POST /v1/topic 5 бесплатно

Детектор тематики (рубрика)

Параметры: text ИЛИ domain/url
Возвращает: category, full_path, confidence

POST /v1/language 5 бесплатно

Детектор языка

Параметры: text ИЛИ domain/url
Возвращает: lang, lang_name, confidence

POST /v1/firecrawl 5 бесплатно

Firecrawl scrape (markdown/html)

Параметры: url
Возвращает: html, http_status, length

POST /v1/whois 5 бесплатно

WHOIS-чекер (через Firecrawl на whois.com)

Параметры: domain
Возвращает: html (whois.com), http_status

POST /v1/ahrefs-dr

Ahrefs Domain Rating

Параметры: domain
Возвращает: dr (0–100)

POST /v1/ahrefs-backlinks

Ahrefs backlinks

Параметры: target/domain, limit≤1000
Возвращает: backlinks[], count

POST /v1/dataforseo-backlinks

DataForSEO backlinks

Параметры: target/domain, limit≤1000
Возвращает: referring_domains[]

POST /v1/dataforseo-serp

DataForSEO SERP

Параметры: keyword, location_code=2643, language_name=Russian, depth≤100
Возвращает: results[] (rank,title,url,domain,snippet)

POST /v1/keyso 5 бесплатно

keys.so (домен/выдача)

Параметры: domain ИЛИ keyword (engine,region,base,top)
Возвращает: dashboard ИЛИ serp_history

POST /v1/mutagen 5 бесплатно

Mutagen (конкуренция запроса)

Параметры: keyword, region_id?
Возвращает: strong, wordstat, tails

POST /v1/donor-select 5 бесплатно

Подбор ссылочных доноров

Параметры: categories[] и/или keywords[], take≤200, budget?, country?
Возвращает: selected[] доноров с DR/TF/ценой/релевантностью

POST /v1/llm 5 бесплатно

LLM passthrough (OpenRouter)

Параметры: model (слаг OpenRouter) ИЛИ model_key (gpt-5/claude-…), prompt ИЛИ messages
Возвращает: content, usage (стоимость по факту × 1.5)

POST /v1/pagespeed 5 бесплатно

Google PageSpeed Insights

Параметры: url, strategy=mobile|desktop
Возвращает: score, lcp_ms, cls, fcp_ms, tbt_ms

POST /v1/index-acceleration 5 бесплатно

Ускорение индексации (SpeedyIndex)

Параметры: url ИЛИ urls[] (≤100), engine=google|yandex
Возвращает: submitted, result (цена ∝ числу URL)

POST /v1/serp-xmlstock 5 бесплатно

Парсинг выдачи (xmlstock)

Параметры: keyword, engine=yandex|google, region, top_n≤100
Возвращает: results[] (url,title,snippet)

POST /v1/serp-xmlriver 5 бесплатно

Парсинг выдачи (xmlriver)

Параметры: keyword, engine=yandex|google, region, top_n≤100
Возвращает: results[] (url,title,snippet)

7. Прайс

Перепродаваемые сторонние сервисы — наша закупка × 1.5. Свои классификаторы — символический флэт. Курс USD→RUB настраивается. Динамические (LLM, бэклинки, индексация) — по фактической стоимости провайдера × 1.5.

ЭндпоинтНазначениеЦена/вызовFree
commerceКлассификатор коммерческости0.1000 ₽5 бесплатно
topicДетектор тематики (рубрика)0.1000 ₽5 бесплатно
languageДетектор языка0.1000 ₽5 бесплатно
firecrawlFirecrawl scrape (markdown/html)0.1500 ₽5 бесплатно
whoisWHOIS-чекер (через Firecrawl на whois.com)0.1500 ₽5 бесплатно
ahrefs_drAhrefs Domain Rating0.0400 ₽
ahrefs_backlinksAhrefs backlinksпо факту × 1.5
dataforseo_backlinksDataForSEO backlinks3.0000 ₽
dataforseo_serpDataForSEO SERP0.4600 ₽
keysokeys.so (домен/выдача)1.5000 ₽5 бесплатно
mutagenMutagen (конкуренция запроса)0.7500 ₽5 бесплатно
donor_selectПодбор ссылочных доноров0.5000 ₽5 бесплатно
llmLLM passthrough (OpenRouter)по факту × 1.55 бесплатно
pagespeedGoogle PageSpeed Insights0.1000 ₽5 бесплатно
index_accelerationУскорение индексации (SpeedyIndex)по факту × 1.55 бесплатно
serp_xmlstockПарсинг выдачи (xmlstock)0.2300 ₽5 бесплатно
serp_xmlriverПарсинг выдачи (xmlriver)0.2300 ₽5 бесплатно

Поддержка: @bezseo_support · Swagger UI