A Casa de Máquinas
← qannasapi.comUma 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.
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.
# 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.
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
01Cote de graça o custo exato em créditos de qualquer ação antes de executá-la.
Leia os cabeçalhos de créditos
02Audite cada cobrança direto na resposta, sem conciliação no fim do mês.
Lide com resultados vazios e retentativas
03Diferencie um resultado vazio de uma falha e só repita o que é seguro repetir.
Monte uma lista de leads
04Buscar, achar o e-mail, verificar — uma chamada em vez de três, cobrada por etapa.
Limpe uma lista de e-mails
05Verifique uma lista em lote e receba um relatório de degradação, sem montar sua própria fila.
Conecte um cliente MCP
06Aponte 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.
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.
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.