A Casa de Máquinas

Uma chave. O catálogo inteiro. Um comprovante em cada resposta.

O QannasAPI é a API unificada de dados da web pública por trás dos jobs prontos da nossa página inicial. Um POST, um bearer token, um envelope JSON — pessoas, empresas, contatos, sites, SERP, anúncios, mapas e os classificados do Golfo. Estime qualquer chamada de graça, pague só por resultados e leia a cobrança exata nos headers da resposta.

Pegue sua chave de API Leia a referência da API

Créditos grátis únicos · Chaves qk_test_ nunca faturam · Uma busca sem resultado retorna data: null e cobra 0

Não é desenvolvedor? Os jobs da nossa página inicial rodam estes mesmos endpoints — sem precisar de código.

Visão geral

O que você recebe atrás de uma chave

A infraestrutura que uma equipe de dados teria que construir e manter — já atrás do mesmo bearer token.

Uma chave, uma fatura, um esquema

Cada ação retorna o mesmo envelope: { status, request_id, data }. O código que você escreve para a primeira chamada continua funcionando na décima milésima.

Cobrança somente por resultados

Uma chamada sem resultado é HTTP 200 com data: null e X-Credits-Charged: 0. Falhas de origem nunca são faturadas e podem ser repetidas com segurança.

Estimativas grátis para tudo

POST /v1/data/{action}:estimate cota o custo em créditos e não cobra nada. Os workflows também aceitam dry_run: true.

Workflows no servidor

Seis jobs encadeados rodam do nosso lado, com cobrança somente por resultados em cada etapa — uma chamada em vez de cinco, e você paga apenas pelas etapas que produziram dados.

Quickstart

Primeira chamada em três passos

Sem proxies para rotacionar, sem navegadores headless para vigiar, sem parsers para consertar.

1. Crie uma chaveCrie um espaço de trabalho, confirme seu e-mail e depois crie uma chave qk_live_ ou qk_test_. Toda requisição carrega Authorization: Bearer.
2. Estime de graçaPOST /v1/data/{action}:estimate retorna o custo em créditos da chamada que você está prestes a fazer e cobra zero.
3. ChameO mesmo envelope, sempre. Leia X-Credits-Charged e X-Credits-Balance nos headers da resposta para saber exatamente quanto custou.

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":{...}}

Chaves qk_test_ custam zero créditos e estão sujeitas à cota do espaço de trabalho. Cadeias que tocam uma fonte paga retornam fixtures determinísticos; cadeias totalmente de primeira parte podem retornar dados ao vivo.

MCP e agentes

Um servidor MCP hospedado, somente leitura e com escopo definido

O mesmo catálogo, exposto a agentes de IA via Streamable HTTP JSON-RPC 2.0 — incluindo os seis workflows, cada um com uma cotação dry_run gratuita.

Endpoint

POSThttps://api.qannasapi.com/mcp

Streamable HTTP · JSON-RPC 2.0 · 34 tools · 13 read-only scopes

34 ferramentas de escopo definido

28 ferramentas de dados e uso mais as 6 ferramentas de workflow. Chame tools/list para descobrir o conjunto atual do seu token em vez de confiar em uma lista copiada.

Somente leitura por construção

Todos os 13 escopos são de leitura. Não existe escopo de escrita a reter — um token pode consultar informações e nunca pode alterar, enviar ou excluir nada.

Tokens com negação por padrão

Tokens qm_ são exibidos uma única vez, armazenados como digest SHA-256, criados por proprietários e administradores do espaço de trabalho e revogados instantaneamente (a requisição seguinte falha).

Custo reportado na própria resposta

Cada resultado de ferramenta carrega _credits_charged e _credits_balance, então um agente pode dizer ao usuário quanto uma chamada custou sem uma segunda requisição.

Autenticação: leia isto antes de planejar uma integração

O endpoint MCP atualmente aceita um bearer token estático — ainda não há OAuth, embora esteja no roadmap. Na prática, isso significa que qualquer cliente com um campo de header personalizado conecta hoje, enquanto diretórios de conectores hospedados que exigem um fluxo de login OAuth ainda não conseguem. Não declaramos um cliente como suportado até que ele passe no nosso próprio teste de fumaça em staging.

Lacunas conhecidas — listadas de propósito

Cursores delta (since_cursor / track_delta) são exclusivos da REST e não são repassados pelas ferramentas MCP.
Contatos verificados por consenso, anúncios de classificados e sinais de contratação são exclusivos da REST. Workflows de agentes chegam a eles por meio de uma receita, não de uma chamada de ferramenta.
Chamadas MCP sempre gastam créditos reais — não há sandbox de chave de teste no caminho do token qm_.

Qualquer cliente MCP cujas configurações aceitem uma URL mais um header personalizado vai conectar: nome do header Authorization, valor Bearer seguido do seu token. Configurações prontas para copiar e colar são publicadas para cada cliente conforme ele passa no nosso teste de fumaça.

SDKs e ferramentas

Gere um cliente, ou apenas leia a especificação

O documento OpenAPI 3.1 é o contrato; todo o resto é gerado a partir dele.

OpenAPI 3.1

A especificação pública completa, hospedada neste site e segura para apontar um gerador.

Referência interativa

Cada endpoint, esquema e exemplo, tudo navegável — com os corpos de requisição que você vai realmente enviar.

Coleções Postman

A coleção da API mais as coleções de receitas, geradas da mesma especificação para que não possam divergir.

Adaptadores de automação

Nós e conectores para as plataformas de automação mais comuns já estão prontos; as listagens nos marketplaces estão em andamento.

Leia a referência da API OpenAPI 3.1

Receitas

Receitas completas com a aritmética real dos créditos

Cada uma mostra a estimativa, a sequência de chamadas e quanto custa de verdade.

Estime antes de chamar

Cote de graça o custo exato em créditos de qualquer ação antes de executá-la.

Leia os cabeçalhos de créditos

Audite cada cobrança direto na resposta, sem conciliação no fim do mês.

Lide com resultados vazios e retentativas

Diferencie um resultado vazio de uma falha e só repita o que é seguro repetir.

Monte uma lista de leads

Buscar, achar o e-mail, verificar — uma chamada em vez de três, cobrada por etapa.

Limpe uma lista de e-mails

Verifique uma lista em lote e receba um relatório de degradação, sem montar sua própria fila.

Conecte um cliente MCP

Aponte um agente para o servidor MCP hospedado e deixe que ele cote o próprio trabalho antes.

Cursores delta filtram o que você recebe; eles não dão desconto. Uma checagem que não retorna nada novo continua custando zero, porque nada foi encontrado.

Receitas

Preços e medição

Você pode auditar cada cobrança direto da resposta

Créditos, preços públicos por ação e três headers que dizem exatamente onde você está.

Headers em cada chamada de dados

X-Credits-Charged, X-Credits-Balance e X-Price-Book. Sem reconciliação no fim do mês, sem adivinhação.

Preço por resultado nas buscas

As buscas cobram por contato encontrado, não por tentativa. Uma busca maior custa mais porque retorna mais.

Avaliação gratuita

Uma cota única de créditos no cadastro, mais chaves qk_test_ que nunca faturam e estão sujeitas à cota do espaço de trabalho.

Volume e enterprise

Tabelas de preços personalizadas, níveis de limite de taxa mais altos e tetos de gasto provisionados para equipes operando em escala.

Tabela pública de preços

Preços em créditos por ação

Estas são as tarifas públicas padrão por ação do site. As ações por resultado são cobradas por cada resultado retornado, e todas as demais por chamada; a cobrança só ocorre quando a ação é bem-sucedida. O portal mostra o preço exato aplicável ao seu espaço de trabalho, que pode ser diferente se houver preços personalizados.

Contatos e enriquecimento

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 / resultado
Company searchsearch_companies1 cr / resultado
Lead searchsearch_leads1 cr / resultado
Company employees searchsearch_company_employees1 cr / resultado
Lookalike searchsearch_lookalikes1 cr
Competitor followerscompetitor_followers1 cr / resultado

Dubizzle / classificados MENA

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

SERP e SEO

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

Maps e local

Maps placesmaps_places1 cr
Maps reviewsmaps_reviews1 cr

Social, posts e sinais

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

Empregos e IA

Job searchsearch_jobs1 cr
AI enrichai_enrich1 cr
AI personalityai_personality1 cr

Catálogo ao vivo: GET /v1/meta/actions · Estimativas de custo por chamada: POST /v1/data/{action}:estimate · Desempenho real por ação: GET /v1/meta/hit-rates

Veja os planos e a tabela completa de preços

Confiabilidade

Julgue-nos pelos nossos números

Taxas de acerto publicadas

GET /v1/public/hit-rates retorna estatísticas anonimizadas e protegidas por coorte sobre a frequência com que realmente retornamos dados. Sem necessidade de chave.

Estimativas não custam nada

Cote qualquer ação ou workflow antes de rodar, quantas vezes quiser, por zero créditos.

Falhas honestas

Uma cadeia sem rota retorna 501 not_implemented em vez de um resultado vazio plausível — e erros de origem nunca são cobrados.

Comece com uma estimativa grátis.

Crie uma chave, cote uma chamada e veja o contrato inteiro por conta própria antes de gastar um crédito.