Skip to main content

​
Primeiros passos

Scraping síncrono

O endpoint scrape executa uma sessão de navegador e devolve HTML renderizado num único pedido — ideal para integrações de baixa latência.

Tarefas assíncronas

Os endpoints jobs colocam scrapes na fila e permitem consultar o estado e os resultados — ideal para alto volume ou páginas lentas.

​
Arquitetura REST

A API de web scraping segue os princípios REST, com URLs previsíveis orientadas a recursos e códigos de estado HTTP padrão para integração fluida e tratamento de erros.

​
Segurança HTTPS

Todas as comunicações da API são protegidas com TLS 1.2 ou superior para garantir a integridade e privacidade dos dados.

​
Versões da API

A API de web scraping mantém compatibilidade retroativa através de versionamento e opera atualmente na Versão 1.

​
Autenticação

A sua chave API é a credencial exclusiva para aceder à API de web scraping. Cada serviço Cleariflow requer uma chave única. Inclua a sua chave no corpo JSON como api_key.

​
URL base

​
Renderização de páginas

As páginas são renderizadas num navegador headless real. JavaScript é totalmente executado antes de devolver o conteúdo. A proteção SSRF integrada bloqueia pedidos a localhost e intervalos de IP privados.

​
Códigos de resposta e erro

Quando os pedidos falham, a API devolve respostas de erro JSON estruturadas com códigos e descrições específicos para resolução eficaz de problemas.