{
"data": [
{
"value": "4010.00",
"raw_text": "4,010.00"
}
],
"validation": {
"status": "ok",
"reason": "no_reference",
"value": 4010,
"model_value": 4010,
"raw_text": "4,010.00",
"reference": null,
"change_pct": null,
"suspect_pct": 10,
"reject_pct": 30,
"on_page": true,
"votes": [],
"mode": "shadow",
"reference_source": null
}
}
curl --location --request GET 'https://zylalabs.com/api/14423/ai+web+extraction+api/36427/extract+from+page?url=https://www.investing.com/commodities/gold&parse_description=Current gold futures price as a plain number, in a field called value&expiration_seconds=600&raw_text=true&value_field=value&last_value=4012.5&max_chars=6000' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": [
{
"value": 4066.5
}
],
"validation": {
"status": "ok",
"reason": "no_reference",
"value": 4066.5,
"model_value": 4066.5,
"raw_text": null,
"suspect_pct": 10,
"reject_pct": 30,
"on_page": null,
"votes": [],
"mode": "shadow"
}
}
curl --location --request GET 'https://zylalabs.com/api/14423/ai+web+extraction+api/36428/extract+from+screenshot?url=https://www.investing.com/commodities/gold&llm_instructions=Current gold price in USD as a number, in a field called value&expiration_seconds=600&value_field=value&last_value=4012.5' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a AI Web Extraction API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
(Economize 2 meses com cobrança anual 🎉)
Um objeto JSON com duas partes: dados, os campos que você pediu na sua instrução, e validação, uma verificação do valor numérico principal (status ok, suspeito, rejeitado ou não verificado, o motivo, o texto bruto conforme escrito na página e os limites usados)
Em linguagem simples, através de parse_description (ponto de extremidade de texto) ou llm_instructions (ponto de extremidade de captura de tela). Nomeie os campos que deseja de volta, por exemplo "nome do produto, preço em USD como um número e disponibilidade, em campos chamados nome, preço e em_estoque"
Use Extrair da Página por padrão é mais rápido e funciona no texto da página Mude para Extrair de Captura de Tela quando os dados só aparecem uma vez que a página é renderizada como gráficos widgets tabelas em canvas ou aplicativos pesados em JavaScript
Se o número está realmente escrito na página (on_page), se parece uma mudança decimal (x10, x100) e quão longe ele se moveu do último valor aceito para a mesma URL e instrução Você sempre recebe a resposta o status informa quanto confiar nela
Sim envie last_value com o último número que você armazenou para esse URL e instrução e a validação compara com ele em vez do histórico de serviços Use value_field quando sua resposta tiver vários números
Não A página e a resposta são reutilizadas para a mesma URL e instrução enquanto forem mais jovens que expiration_seconds (padrão 600 segundos) Envie 0 para forçar uma nova obtenção
Extrair da Página lê o texto renderizado pelo servidor Para conteúdo que só aparece depois que a página executa seus scripts use Extrair da Captura de Tela que renderiza a página em um navegador antes de lê-la
A resposta vem com erro verdadeiro e uma mensagem descrevendo o problema (página bloqueada, tempo limite, erro a montante) A chamada não é contada como bem-sucedida
Ambos os endpoints retornam dados JSON estruturados. O endpoint Extrair da Página fornece campos com base no texto da página, enquanto o endpoint Extrair do Captura de Tela retorna dados derivados de visuais renderizados, como gráficos ou widgets
Os campos principais incluem "dados", que contém os valores extraídos, e "validação", que fornece o status da extração, a razão da validação e verifica dados históricos
A resposta está estruturada em duas seções principais: "dados," que contém os campos solicitados, e "validação," que detalha as verificações de precisão realizadas em valores numéricos, incluindo status e motivo
Extração de Página é adequado para dados textuais como preços e especificações enquanto Extração de Captura de Tela é ideal para dados visuais como gráficos e conteúdo dinâmico que requer renderização
Os usuários podem personalizar solicitações especificando o "parse_description" para Extrair da Página ou "llm_instructions" para Extrair da Captura de Tela, detalhando os campos exatos que desejam extrair
Os dados são obtidos de páginas da web acessíveis ao público A API busca o conteúdo diretamente da URL fornecida garantindo que as informações estejam atuais e relevantes
A precisão dos dados é mantida através de uma camada de validação que verifica os valores numéricos em relação ao texto da página, dados históricos e possíveis alterações decimais, fornecendo aos usuários um status de confiança para cada extração
Casos de uso típicos incluem monitoramento de preços de commodities análise de concorrentes extração de especificações de produtos e fornecimento de dados em tempo real para agentes de IA para tomada de decisões