/agent é uma API mágica que pesquisa, navega e coleta dados até mesmo dos sites mais complexos, encontrando dados em locais de difícil acesso e descobrindo dados em qualquer lugar da internet. Ele realiza em poucos minutos o que levaria muitas horas para um humano e torna o web scraping tradicional obsoleto.
Basta descrever quais dados você quer e o /agent cuida do resto.
Prévia de pesquisa: Agent está em acesso antecipado (early access). Espere algumas imperfeições. Ele ficará significativamente melhor com o tempo. Compartilhe feedback →
/extract e leva isso além:
- Nenhuma URL necessária: Basta descrever o que você precisa no parâmetro
prompt. URLs são opcionais. - Pesquisa aprofundada na web: Pesquisa e navega autonomamente em profundidade em sites para encontrar seus dados
- Confiável e preciso: Funciona com uma grande variedade de consultas e casos de uso
- Mais rápido: Processa múltiplas fontes em paralelo para resultados mais rápidos
- Mais barato: Agent é mais econômico do que
/extractpara casos de uso complexos
Usando /agent
prompt. Basta descrever quais dados deseja extrair. Para obter uma saída estruturada, forneça um schema JSON. Os SDKs oferecem suporte a Pydantic (Python) e Zod (Node) para definições de schema com segurança de tipos:
Resposta
JSON
Fornecendo URLs (Opcional)
Status e conclusão de jobs
- Método padrão:
agent()aguarda e retorna os resultados finais - Iniciar e depois consultar: use
start_agent(Python) oustartAgent(Node) para obter um Job ID imediatamente e depois verificar o status comget_agent_status/getAgentStatus
Os resultados do job ficam disponíveis por 24 horas após a conclusão.
Estados possíveis
| Status | Descrição |
|---|---|
processing | O agente ainda está trabalhando na sua solicitação |
completed | Extração concluída com sucesso |
failed | Ocorreu um erro durante a extração |
Exemplo pendente
JSON
Exemplo concluído
JSON
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
prompt | string | Sim | Descrição em linguagem natural dos dados que você quer extrair (máx. 10.000 caracteres) |
urls | array | Não | Lista opcional de URLs para direcionar a extração |
schema | object | Não | Esquema JSON opcional para saída estruturada |
Agent vs Extract: O que melhorou
| Recurso | Agent (Novo) | Extract |
|---|---|---|
| URLs obrigatórias | Não | Sim |
| Velocidade | Mais rápida | Padrão |
| Custo | Mais baixo | Padrão |
| Confiabilidade | Maior | Padrão |
| Flexibilidade das consultas | Alta | Moderada |
Exemplos de Casos de Uso
- Pesquisa: “Encontre as 5 principais startups de IA e seus valores de financiamento”
- Análise de concorrência: “Compare os planos de preços do Slack e do Microsoft Teams”
- Coleta de dados: “Extraia informações de contato de sites de empresas”
- Resumo de conteúdo: “Resuma as postagens de blog mais recentes sobre web scraping”
Referência da API
Preços
Como funciona o preço do Agent
- Extrações simples (como informações de contato de uma única página) normalmente consomem menos créditos e custam menos
- Tarefas de pesquisa complexas (como análise de concorrência em vários domínios) consomem mais créditos, mas refletem o esforço total envolvido
- Uso transparente mostra exatamente quantos créditos cada requisição consumiu
- Conversão de créditos converte automaticamente o uso de créditos do Agent em créditos para facilitar a cobrança
O uso de créditos varia de acordo com a complexidade do seu prompt, a quantidade de dados processados e a estrutura do resultado solicitado.
Começando
Gerenciando custos
- Comece com execuções gratuitas: Use suas 5 solicitações gratuitas diárias para entender os preços
- Defina o parâmetro
maxCredits: Limite seus gastos definindo um número máximo de créditos que você está disposto a usar - Otimize os prompts: Prompts mais específicos geralmente usam menos créditos
- Monitore o uso: Acompanhe seu consumo pelo painel
- Ajuste expectativas: Pesquisas complexas em múltiplos domínios vão consumir mais créditos do que extrações simples de uma única página
Os preços estão sujeitos a alteração à medida que avançamos de Research Preview para disponibilidade geral. Usuários atuais receberão aviso antecipado sobre quaisquer atualizações de preços.

