QannasAPI

Машинное отделение

← qannasapi.com

Один ключ. Весь каталог. Квитанция в каждом ответе.

QannasAPI — единый API данных открытого веба, лежащий в основе готовых задач с нашей главной страницы. Один POST, один bearer-токен, один JSON-конверт — люди, компании, контакты, сайты, SERP, реклама, карты и классифайды стран Залива. Оценивайте любой вызов бесплатно, платите только за результат и читайте точное списание из заголовков ответа.

Получить API-ключЧитать справочник API

Бесплатные кредиты один раз · ключи 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. 1. Создайте ключСоздайте рабочее пространство, подтвердите email, затем создайте ключ qk_live_ или qk_test_. Каждый запрос несёт Authorization: Bearer.
  2. 2. Оцените бесплатноPOST /v1/data/{action}:estimate возвращает стоимость в кредитах вызова, который вы собираетесь сделать, и списывает ноль.
  3. 3. ВызовитеКаждый раз один и тот же конверт. Читайте X-Credits-Charged и X-Credits-Balance из заголовков ответа, чтобы точно знать, сколько это стоило.
estimate-then-call.sh
# 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 плюс коллекции рецептов, сгенерированные из той же спецификации, — поэтому они не могут с ней разойтись.

Адаптеры автоматизации

Ноды и коннекторы для популярных платформ автоматизации готовы; публикации в маркетплейсах — в процессе.

Читать справочник APIOpenAPI 3.1

Рецепты

Готовые рецепты с реальной арифметикой кредитов

Каждый показывает оценку, последовательность вызовов и фактическую стоимость.

Оцените до вызова

01

Бесплатно узнайте точную стоимость любого действия в кредитах до его запуска.

Читайте заголовки кредитов

02

Проверяйте каждое списание прямо из ответа, без сверки в конце месяца.

Обрабатывайте пустые ответы и повторы

03

Отличайте пустой результат от сбоя и повторяйте только то, что безопасно повторять.

Соберите список лидов

04

Найти, получить адрес, проверить его — один вызов вместо трёх, с оплатой за шаг.

Очистите список адресов

05

Проверьте список пакетом и получите отчёт о деградации, не собирая очередь вручную.

Подключите MCP-клиент

06

Направьте агента на размещённый MCP-сервер и дайте ему сначала оценить свою работу.

Дельта-курсоры фильтруют то, что вы получаете, а не дают на это скидку. Проверка, не нашедшая ничего нового, по-прежнему ничего не списывает — потому что ничего не найдено.

Рецепты

Цены и учёт

Каждое списание можно проверить прямо по ответу

Кредиты, публичные цены за действие и три заголовка, которые точно показывают, где вы находитесь.

Заголовки в каждом вызове данных

X-Credits-Charged, X-Credits-Balance и X-Price-Book. Никакой сверки в конце месяца, никаких догадок.

Цена за результат в поисках

Поиски тарифицируются за найденный контакт, а не за попытку. Больший поиск стоит дороже, потому что возвращает больше.

Бесплатная проверка

Одноразовый грант кредитов при регистрации плюс ключи qk_test_, которые никогда не тарифицируются и ограничены квотой рабочего пространства.

Объёмы и enterprise

Индивидуальные прайс-листы, повышенные уровни лимитов запросов и настраиваемые потолки расходов для команд, работающих в масштабе.

Публичный прайс-лист

Цены в кредитах за действие

Это стандартные публичные тарифы сайта за действие. Операции с оплатой за результат тарифицируются за каждый возвращённый результат; остальные — за вызов. Нет результата — нет списания. Портал показывает точную цену для рабочего пространства; при индивидуальном ценообразовании она может отличаться.

Контакты и обогащение

  • Email findfind_email5 cr
  • Email verifyverify_email1 cr
  • Phone findfind_phone10 cr
  • Person enrichenrich_person3 cr
  • Company enrichenrich_company3 cr
  • Reverse lookupreverse_lookup1 cr
  • People searchsearch_people1 cr / результат
  • Company searchsearch_companies1 cr / результат
  • Lead searchsearch_leads1 cr / результат
  • Company employees searchsearch_company_employees1 cr / результат
  • Lookalike searchsearch_lookalikes1 cr
  • Competitor followerscompetitor_followers1 cr / результат

Dubizzle / классифайды MENA

  • Classifieds listing searchlistings_search2 cr
  • Listing detailslisting_details2 cr
  • Agent listingsagent_listings2 cr
  • Listing phone reveallisting_phone15 cr

SERP и SEO

  • SERP (Google results)serp1 cr
  • Keywordskeywords1 cr
  • Backlinksbacklinks1 cr
  • Trendstrends1 cr
  • Ads searchads_search1 cr
  • Ads detailsads_details1 cr

Карты и локальные данные

  • Maps placesmaps_places1 cr
  • Maps reviewsmaps_reviews1 cr

Аналитика сайтов

  • Website intelligencewebsite_intelligence1 cr
  • Tech stackwebsite_tech_stack1 cr
  • Website contactswebsite_contacts1 cr
  • Social linkswebsite_social_links1 cr
  • Domain resolvewebsite_resolve1 cr
  • Tracking pixelswebsite_pixels1 cr
  • Page scrapewebsite_scrape1 cr
  • Sitemapwebsite_sitemap1 cr
  • Meta tagswebsite_meta_tags1 cr
  • JSON-LDwebsite_json_ld1 cr
  • Traffic snapshotwebsite_traffic1 cr

Соцсети, посты и сигналы

  • Posts searchposts_search1 cr
  • Posts & activitiesposts_activities1 cr
  • Funding roundsfunding1 cr
  • Signal: funding eventssignals_funding_events1 cr
  • Signal: headcount growthsignals_headcount_growth1 cr
  • Signal: job changessignals_job_changes1 cr

YouTube

  • YouTube searchyoutube_search1 cr
  • YouTube videoyoutube_video1 cr
  • YouTube channelyoutube_channel1 cr
  • Channel videosyoutube_channel_videos1 cr

Вакансии и ИИ

  • Job searchsearch_jobs1 cr
  • AI enrichai_enrich1 cr
  • AI personalityai_personality1 cr

Живой каталог: GET /v1/meta/actions · Оценка стоимости вызова: POST /v1/data/{action}:estimate · Реальная производительность по действиям: GET /v1/meta/hit-rates

Смотреть планы и полный прайс-лист

Надёжность

Судите нас по нашим цифрам

Публичные hit-rate

GET /v1/public/hit-rates возвращает анонимизированную, защищённую когортированием статистику того, как часто мы действительно возвращаем данные. Ключ не требуется.

Оценки ничего не стоят

Оценивайте любое действие или воркфлоу до запуска, сколько угодно раз, за ноль кредитов.

Честные сбои

Немаршрутизированная цепочка возвращает 501 not_implemented, а не правдоподобный пустой результат, — а ошибки апстрима никогда не тарифицируются.

Начните с бесплатной оценки.

Создайте ключ, оцените вызов и изучите весь контракт сами, прежде чем потратить хоть один кредит.

Получить API-ключЧитать справочник API