Машинное отделение
← qannasapi.comОдин ключ. Весь каталог. Квитанция в каждом ответе.
QannasAPI — единый API данных открытого веба, лежащий в основе готовых задач с нашей главной страницы. Один POST, один bearer-токен, один JSON-конверт — люди, компании, контакты, сайты, SERP, реклама, карты и классифайды стран Залива. Оценивайте любой вызов бесплатно, платите только за результат и читайте точное списание из заголовков ответа.
Бесплатные кредиты один раз · ключи qk_test_ никогда не тарифицируются · промах возвращает data: null и списывает 0
Не разработчик? Задачи на нашей главной странице работают на тех же эндпоинтах — код не нужен.
Обзор
Что вы получаете за одним ключом
Вся инфраструктура, которую команде данных иначе пришлось бы строить и поддерживать самим, — уже за тем же bearer-токеном.
Один ключ, один счёт, одна схема
Каждое действие возвращает один и тот же конверт: { status, request_id, data }. Код, который вы напишете для первого вызова, будет работать и на десятитысячном.
Оплата только за результат
Вызов без результата — это HTTP 200 с data: null и X-Credits-Charged: 0. Сбои апстрима никогда не тарифицируются, и их безопасно повторять.
Бесплатная оценка для всего
POST /v1/data/{action}:estimate называет цену в кредитах и ничего не списывает. Воркфлоу также принимают dry_run: true.
Серверные воркфлоу
Шесть связанных задач выполняются на нашей стороне с пошаговой оплатой только за результат — один вызов вместо пяти, и вы платите только за шаги, которые вернули данные.
Быстрый старт
Первый вызов за три шага
Никакой ротации прокси, никаких headless-браузеров под присмотром, никаких парсеров на починке.
- 1. Создайте ключСоздайте рабочее пространство, подтвердите email, затем создайте ключ qk_live_ или qk_test_. Каждый запрос несёт Authorization: Bearer.
- 2. Оцените бесплатноPOST /v1/data/{action}:estimate возвращает стоимость в кредитах вызова, который вы собираетесь сделать, и списывает ноль.
- 3. ВызовитеКаждый раз один и тот же конверт. Читайте X-Credits-Charged и X-Credits-Balance из заголовков ответа, чтобы точно знать, сколько это стоило.
# 1 — what will this cost? (free)
curl -X POST https://api.qannasapi.com/v1/data/contacts/find-email:estimate \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Jane Doe, Acme Logistics"}'
# 2 — run it. Same envelope, every time.
curl -X POST https://api.qannasapi.com/v1/data/contacts/find-email \
-H "Authorization: Bearer $QANNAS_API_KEY" \
-d '{"query": "Jane Doe, Acme Logistics"}'
# < 200 OK
# < X-Credits-Charged: 5
# < X-Credits-Balance: 95
# {"status":"OK","request_id":"...","data":{...}}Ключи qk_test_ стоят ноль кредитов и ограничены квотой рабочего пространства. Цепочки, затрагивающие платный источник, возвращают детерминированные фикстуры; цепочки, работающие только с первоисточниками, могут возвращать живые данные.
MCP и агенты
Размещённый MCP-сервер с ограниченными правами, только для чтения
Тот же каталог, открытый ИИ-агентам по Streamable HTTP JSON-RPC 2.0, — включая шесть воркфлоу, у каждого из которых есть бесплатная оценка dry_run.
Эндпоинт
POSThttps://api.qannasapi.com/mcp
Streamable HTTP · JSON-RPC 2.0 · 34 tools · 13 read-only scopes
34 инструмента с ограниченной областью действия
28 инструментов данных и учёта плюс 6 инструментов воркфлоу. Вызывайте tools/list, чтобы узнать актуальный набор для вашего токена, вместо того чтобы доверять скопированному списку.
Только чтение по построению
Все 13 областей действия — чтение. Здесь нет write-области, которую можно было бы не выдать: токен может искать данные и никогда не сможет ничего изменить, отправить или удалить.
Токены с запретом по умолчанию
Токены qm_ показываются один раз, хранятся как дайджест SHA-256, создаются владельцами и администраторами рабочего пространства и отзываются мгновенно (следующий запрос завершится ошибкой).
Отчёт о стоимости внутри ответа
Каждый результат инструмента несёт _credits_charged и _credits_balance, так что агент может сообщить пользователю стоимость вызова без второго запроса.
Аутентификация: прочтите это, прежде чем планировать интеграцию
MCP-эндпоинт сейчас принимает статический bearer-токен — OAuth пока нет, хотя он есть в планах. На практике это означает, что сегодня подключится любой клиент с полем для настраиваемого заголовка, а размещённые каталоги коннекторов, требующие входа через OAuth, — пока нет. Мы не называем клиент поддерживаемым, пока он не пройдёт наш собственный smoke-тест на стейджинге.
Известные пробелы — перечислены намеренно
- Дельта-курсоры (since_cursor / track_delta) доступны только в REST и не пробрасываются в MCP-инструменты.
- Контакты, подтверждённые консенсусом, объявления классифайдов и сигналы найма доступны только в REST. Агентские воркфлоу добираются до них через рецепт, а не через вызов инструмента.
- Вызовы MCP всегда тратят реальные кредиты — на пути токенов qm_ нет песочницы с тестовыми ключами.
Подключится любой MCP-клиент, в настройках которого есть URL и настраиваемый заголовок: имя заголовка — Authorization, значение — Bearer и далее ваш токен. Готовые конфигурации для конкретных клиентов публикуются по мере того, как каждый из них проходит наш smoke-тест.
SDK и инструменты
Сгенерируйте клиент — или просто читайте спецификацию
Документ OpenAPI 3.1 — это контракт; всё остальное генерируется из него.
OpenAPI 3.1
Полная публичная спецификация, размещённая на этом сайте, — на неё безопасно направить генератор.
Интерактивный справочник
Каждый эндпоинт, схема и пример — в удобном для просмотра виде, с телами запросов, которые вы действительно будете отправлять.
Коллекции Postman
Коллекция API плюс коллекции рецептов, сгенерированные из той же спецификации, — поэтому они не могут с ней разойтись.
Адаптеры автоматизации
Ноды и коннекторы для популярных платформ автоматизации готовы; публикации в маркетплейсах — в процессе.
Рецепты
Готовые рецепты с реальной арифметикой кредитов
Каждый показывает оценку, последовательность вызовов и фактическую стоимость.
Оцените до вызова
01Бесплатно узнайте точную стоимость любого действия в кредитах до его запуска.
Читайте заголовки кредитов
02Проверяйте каждое списание прямо из ответа, без сверки в конце месяца.
Обрабатывайте пустые ответы и повторы
03Отличайте пустой результат от сбоя и повторяйте только то, что безопасно повторять.
Соберите список лидов
04Найти, получить адрес, проверить его — один вызов вместо трёх, с оплатой за шаг.
Очистите список адресов
05Проверьте список пакетом и получите отчёт о деградации, не собирая очередь вручную.
Подключите MCP-клиент
06Направьте агента на размещённый MCP-сервер и дайте ему сначала оценить свою работу.
Дельта-курсоры фильтруют то, что вы получаете, а не дают на это скидку. Проверка, не нашедшая ничего нового, по-прежнему ничего не списывает — потому что ничего не найдено.
Цены и учёт
Каждое списание можно проверить прямо по ответу
Кредиты, публичные цены за действие и три заголовка, которые точно показывают, где вы находитесь.
Заголовки в каждом вызове данных
X-Credits-Charged, X-Credits-Balance и X-Price-Book. Никакой сверки в конце месяца, никаких догадок.
Цена за результат в поисках
Поиски тарифицируются за найденный контакт, а не за попытку. Больший поиск стоит дороже, потому что возвращает больше.
Бесплатная проверка
Одноразовый грант кредитов при регистрации плюс ключи qk_test_, которые никогда не тарифицируются и ограничены квотой рабочего пространства.
Объёмы и enterprise
Индивидуальные прайс-листы, повышенные уровни лимитов запросов и настраиваемые потолки расходов для команд, работающих в масштабе.
Надёжность
Судите нас по нашим цифрам
Публичные hit-rate
GET /v1/public/hit-rates возвращает анонимизированную, защищённую когортированием статистику того, как часто мы действительно возвращаем данные. Ключ не требуется.
Оценки ничего не стоят
Оценивайте любое действие или воркфлоу до запуска, сколько угодно раз, за ноль кредитов.
Честные сбои
Немаршрутизированная цепочка возвращает 501 not_implemented, а не правдоподобный пустой результат, — а ошибки апстрима никогда не тарифицируются.
Начните с бесплатной оценки.
Создайте ключ, оцените вызов и изучите весь контракт сами, прежде чем потратить хоть один кредит.