{
"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/14427/screenshot+to+data+api/36435/extract+from+page?url=https://www.investing.com/commodities/gold&raw_text=true&value_field=value&parse_description=Current gold futures price as a plain number, in a field called value&last_value=4012.5&expiration_seconds=600&max_chars=6000&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/14427/screenshot+to+data+api/36436/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 Screenshot To Data 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ê solicitou em sua instrução, e validação, uma verificação do valor numérico principal (status ok, suspeito, rejeitado ou não verificado, a razão, o texto bruto como escrito na página e os limites usados)
Em linguagem simples, através de parse_description (endpoint de texto) ou llm_instructions (endpoint de captura de tela). Nomeie os campos que você deseja de volta, por exemplo "nome do produto, preço em USD como 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 da Captura de Tela quando os dados aparecem apenas 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 com um deslocamento decimal (x10, x100) e quão longe se moveu do último valor aceito para a mesma URL e instrução Você sempre recebe a resposta; o status diz o quanto confiar nela
Sim Envie last_value com o último número que você armazenou para essa 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 busca
Extração da Página lê o texto renderizado pelo servidor Para conteúdo que aparece apenas após a página executar seus scripts, use Extração 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, timeout, erro de upstream) 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 HTML da página enquanto Extrair da Captura de Tela retorna dados do conteúdo renderizado como gráficos ou widgets Cada resposta inclui um bloco de validação para avaliar a precisão dos valores numéricos
Os campos principais nos dados de resposta incluem "value," que contém os dados numéricos extraídos, e "raw_text," que mostra o texto original da página. O bloco de validação inclui campos como "status," "reason," e "on_page" para indicar a confiabilidade dos dados extraídos
Os dados da resposta estão organizados em duas seções principais: "dados" e "validação" A seção "dados" contém os campos extraídos enquanto a seção "validação" fornece insights sobre a precisão e confiabilidade dos valores numéricos extraídos incluindo status e razões para quaisquer discrepâncias
O Extrair da Página é adequado para dados baseados em texto como preços e especificações enquanto o Extrair da Captura de Tela é projetado para dados visuais que requerem renderização como gráficos e conteúdo dinâmico Ambas as interfaces podem extrair vários tipos de informações com base nas instruções do usuário
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. Eles podem definir os campos que desejam extrair e fornecer um "last_value" para comparações de validação, melhorando a precisão dos resultados
Os dados são extraídos de páginas da web acessíveis publicamente A API obtém o conteúdo diretamente da URL especificada garantindo que as informações extraídas reflitam os dados mais atuais disponíveis na página
A precisão dos dados é mantida por meio de uma camada de validação que verifica os valores numéricos extraídos em relação ao texto da página, valores históricos e possíveis mudanças decimais Essa processo ajuda a garantir que os dados retornados sejam confiáveis e dignos de confiança
Os casos de uso típicos incluem monitoramento de preços de commodities análise de concorrentes extração de especificações de produtos e alimentação de sistemas de IA com dados ao vivo verificados A API é particularmente útil para cenários onde a extração de dados precisa se adaptar a mudanças no design da página da web