API de Scrape: Buscar Páginas da Web com Preço de Crédito Fixo

Categoria Inteligência de domínios e da web

Pontos finais 4

Principais Recursos 6

Perguntas frequentes 8

Usado por pessoas em empresas incríveis

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Ao vivo Status do serviço

Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.

OpenAPI Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

10,000 Cota gratuita

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

O que esta API ajuda você a lançar

Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.

Workflows de produto

Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.

Automação de analistas

Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.

Dados JSON limpos

Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.

IA e operações

Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.

Fluxo de integração

Um caminho simples da primeira requisição ao uso repetível em produção.

Autentique uma vez

Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.

Consulte com exemplos

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Opere e monitore

Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.

Kit de desenvolvedor

Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.

Esquema OpenAPI

Gere clientes ou inspecione cada formato de requisição e resposta.

Coleção Postman

Importe requisições prontas para testes manuais e repasse ao time.

SDKs e CLI

Use pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.

Integração MCP

Exponha inteligência de domínios para agentes de IA e assistentes internos.

Mapa de parâmetros e resposta

Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.

Parâmetros da requisição

Parâmetro

urlmodeoutputurlsjob_idlimitoffset

Campos da resposta

Resposta de Exemplo

datadata.urldata.final_urldata.statusdata.outcomedata.content_typedata.contentdata.bytesdata.truncateddata.redirect_countdata.attempt_countdata.duration_ms

Cobertura de status

Códigos de Estado HTTP

200202400401402403409429503

Pontos finais

POST /v1/scrape

Créditos: 1-20/itemAutenticação: Autenticação necessária

urlmodeoutput

POST /v1/scrape/jobs

Créditos: 1-20/itemAutenticação: Autenticação necessária

modeoutputurls

GET /v1/scrape/jobs/:job_id

Créditos: 0Autenticação: Autenticação necessária

job_id

GET /v1/scrape/jobs/:job_id/results

Créditos: 0Autenticação: Autenticação necessária

job_idlimitoffset

Escolha o esforço de recuperação para cada URL

Créditos são baseados no modo que você solicita, não no status HTTP ou conteúdo retornado pelo site de destino.

Padrão

1 crédito por URL

Uma tentativa de recuperação padrão para páginas diretas.

Resiliente

2 créditos por URL

Uma tentativa padrão com uma tentativa novamente quando o resultado atende as condições de repetição documentadas.

Renderizado

10 créditos por URL

Uma tentativa renderizada pelo navegador para páginas que requerem execução de JavaScript.

Renderizado resiliente

20 créditos por URL

Uma tentativa renderizada pelo navegador com uma tentativa novamente quando o resultado atende as condições de repetição documentadas.

Modos resilientes custam o valor listado mesmo quando a primeira tentativa é bem-sucedida. Eles incluem uma tentativa elegível novamente, não tentativas ilimitadas ou uma garantia de que o site de destino retornará o conteúdo que você espera.

Faturamento reflete o trabalho solicitado

Uma operação de API bem-sucedida significa que o DomScan realizou o modo de recuperação selecionado e retornou a resposta de site de destino resultante.

O resultado ainda pode ser um redirecionamento, um erro HTTP, uma resposta bloqueada, uma página de desafio, uma página vazia ou conteúdo que não atende suas necessidades. Estes resultados de site de destino são faturáveis e não são elegíveis para reembolso de crédito.

Um reembolso está disponível apenas quando o DomScan verifica que sua própria plataforma falhou em realizar o modo de recuperação selecionado.

Renderização do navegador não garante que uma página será carregada com sucesso, e modos resilientes não garantem que a tentativa novamente produzirá um resultado diferente.

Limites de uso específicos de Scrape

Estes limites aplicam-se especificamente à API de Scrape. Outras salvaguardas de conta e plataforma também podem aplicar.

Capacidade	Contas gratuitas	Contas pagas
Modos disponíveis	Apenas padrão	Todos os quatro modos
Taxa de solicitação	5 solicitações por minuto	60 solicitações por minuto
Solicitações simultâneas padrão ou resilientes	1 solicitação padrão	5 solicitações
Solicitações renderizadas simultâneas	Não disponível	2 solicitações
Permissão diária	100 solicitações	Baseado em créditos disponíveis e limites de taxa
Permissão mensal	500 solicitações	Baseado em créditos disponíveis e limites de taxa
Conteúdo máximo retornado	256 KiB por solicitação	512 KiB por solicitação
Lotes assincronos	Não disponível	Disponível

Quando uma resposta excede o limite de conteúdo aplicável, a API retorna a porção permitida e marca a resposta como truncada.

Processe até 100 URLs de forma assincronos

Contas pagas podem enviar um trabalho assincronos contendo até 100 URLs.

Até 5 novos trabalhos em lote por minuto

Até 3 trabalhos ativos por conta

Até 300 itens de URL na fila por conta

Até 100 URLs em um trabalho

Resultados concluídos disponíveis por 24 horas

Metadados de trabalho retidos por 7 dias

Cada URL é faturada independentemente usando seu modo selecionado.

Baixe ou copie resultados concluídos dentro de 24 horas. Após esse período, o conteúdo da resposta é removido mesmo que metadados de trabalho limitados permaneçam disponíveis por 7 dias.

Escopo claro, sem opções de upgrade ocultas

Sem resolução de CAPTCHA

Renderização de navegador pode executar JavaScript de página, mas a API de Scrape não resolve CAPTCHAs ou contorna requisitos de login, paywalls, controles de acesso ou outras restrições. Um CAPTCHA ou página de desafio retornado pelo destino é um resultado de site de destino e não é reembolsável.

Sem seleção premium de proxy

Você escolhe o modo de recuperação e nível de esforço. Não há proxy premium, provedor, pool ou parâmetro de seleção de país.

Uso aceitável

Use a API de Scrape apenas para conteúdo que você é legalmente permitido acessar e processar. Você é responsável por estar em conformidade com leis aplicáveis, termos do site de destino, obrigações de privacidade e permissões necessárias.

Não use a API para contornar autenticação, paywalls, CAPTCHAs ou controles de acesso, ou para ataques de credencial, abuso de conta, assédio, vigilância ilegal ou coleta ilegal de dados pessoais. O DomScan pode rejeitar solicitações ou suspender acesso quando o uso ameaça pessoas, serviços ou a plataforma.

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Status do serviço Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

Cota gratuita Cadastre-se Gratuitamente

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

Ativo Pedido de Exemplo

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Principais Recursos

Escolha o esforço de recuperação para cada URL

Créditos são baseados no modo que você solicita, não no status HTTP ou conteúdo retornado pelo site de destino.

Faturamento reflete o trabalho solicitado

Uma operação de API bem-sucedida significa que o DomScan realizou o modo de recuperação selecionado e retornou a resposta de site de destino resultante.

Processe até 100 URLs de forma assincronos

Contas pagas podem enviar um trabalho assincronos contendo até 100 URLs.

Limites de uso específicos de Scrape

Estes limites aplicam-se especificamente à API de Scrape. Outras salvaguardas de conta e plataforma também podem aplicar.

Sem resolução de CAPTCHA

Uso aceitável

Pedido de Exemplo

Solicitação padrão bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'

Solicitação renderizada pelo navegador bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'

Solicitação de lote assincronos bash

curl -X POST "https://domscan.net/v1/scrape/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Idempotency-Key: docs-batch-1" \
  -H "Content-Type: application/json" \
  -d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'

Resposta de Exemplo

Resposta padrão bem-sucedida json

{
  "data": {
    "url": "https://example.com/",
    "final_url": "https://example.com/",
    "status": 200,
    "outcome": "success",
    "content_type": "text/html",
    "content": "<!doctype html>...",
    "bytes": 1256,
    "truncated": false,
    "redirect_count": 0,
    "attempt_count": 1,
    "duration_ms": 428,
    "fetched_at": "2026-08-20T10:30:00.000Z",
    "headers": { "cache-control": "max-age=604800" },
    "rendered": false
  },
  "billing": {
    "credits_charged": 1,
    "credits_refunded": 0,
    "policy": "effort_based"
  }
}

Perguntas frequentes

Quantos créditos uma URL custa?

Uma URL custa 1, 2, 10 ou 20 créditos dependendo do modo selecionado. Itens em lote usam o mesmo preço por URL.

Sou cobrado se o destino retorna um erro ou página de bloco?

Sim. Respostas de destino como redirecionamentos, erros HTTP, blocos, páginas de desafio, páginas vazias ou conteúdo inesperado são faturáveis porque o DomScan ainda realizou o trabalho de recuperação solicitado.

Quando uma solicitação é reembolsada?

Um reembolso está disponível apenas quando o DomScan verifica que sua própria plataforma falhou em realizar o modo de recuperação selecionado. O comportamento do site de destino não é uma falha de plataforma.

O modo resiliente continua tentando novamente até que a página funcione?

Não. O modo resiliente inclui uma tentativa novamente quando o primeiro resultado atende as condições de repetição documentadas.

A renderização do navegador resolve CAPTCHAs?

Não. Ele executa JavaScript de página mas não resolve CAPTCHAs ou contorna restrições de acesso.

Posso selecionar um proxy premium ou país?

Não. A API não expõe camadas de proxy, provedores, pools ou direcionamento de país. Você seleciona apenas o modo de recuperação.

Contas gratuitas podem enviar trabalhos em lote?

Não. Lotes assincronos estão disponíveis apenas para contas pagas. Contas gratuitas podem usar modo padrão dentro dos limites gratuitos publicados.

Por quanto tempo os resultados do lote são armazenados?

Conteúdo de resposta concluído está disponível por 24 horas. Metadados de trabalho limitado permanecem disponíveis por 7 dias.

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP

Documentamos os códigos de estado HTTP que deves tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados em falta e falhas do serviço a montante.

OK 200

Pedido bem-sucedido

Aceito 202

Falha de cache de subdomínios em modo somente cache aceita para atualização em segundo plano. Nenhum crédito é cobrado; tente novamente após o intervalo Retry-After.

Pedido inválido 400

Parâmetros inválidos

Não autorizado 401

Chave de API ou sessão em falta ou inválida.

Pagamento necessário 402

Não tens créditos suficientes para executar este pedido.

Proibido 403

Autenticado, mas sem permissão para usar esta operação ou modo.

HTTP 409 409

Demasiados pedidos 429

Limite de taxa excedido

Serviço indisponível 503

O serviço a montante está indisponível ou a limitar temporariamente.

Obtenha uma chave de API

Começar Gratuitamente Ver documentação

Suporte

API de Busque páginas da web com preço previsível por URL

Sinais de confiança antes da integração

O que esta API ajuda você a lançar

Fluxo de integração

Kit de desenvolvedor

Mapa de parâmetros e resposta

Pontos finais

Escolha o esforço de recuperação para cada URL

Padrão

Resiliente

Renderizado

Renderizado resiliente

Faturamento reflete o trabalho solicitado

Limites de uso específicos de Scrape

Processe até 100 URLs de forma assincronos

Escopo claro, sem opções de upgrade ocultas

Sem resolução de CAPTCHA

Sem seleção premium de proxy

Uso aceitável

Sinais de confiança antes da integração

Principais Recursos

Pedido de Exemplo

Resposta de Exemplo

Perguntas frequentes

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP