{
"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/14426/price+from+any+url+api/36433/extract+from+page?parse_description=Current gold futures price as a plain number, in a field called value&url=https://www.investing.com/commodities/gold&expiration_seconds=600&raw_text=true&parse_description=Current gold futures price as a plain number, in a field called value&value_field=value&expiration_seconds=600&last_value=4012.5&raw_text=true&max_chars=6000&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/14426/price+from+any+url+api/36434/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 Price From Any URL 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 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 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 da Captura de Tela quando os dados só aparecem uma vez que a página é renderizada como gráficos widgets tabelas 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 ele se moveu do último valor aceito para a mesma URL e instrução Você sempre recebe a resposta o status lhe diz o 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 estão abaixo de expiration_seconds (padrão 600 segundos) Envie 0 para forçar uma nova busca
O Extrair da Página lê o texto renderizado pelo servidor Para conteúdo que aparece apenas 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 de upstream) A chamada não é contada como bem-sucedida
Ambos os pontos finais retornam dados JSON estruturados O ponto final Extrair da Página fornece campos com base no texto da página enquanto o ponto final Extrair da Captura de Tela retorna dados de 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" (os dados numéricos extraídos), "raw_text" (o texto como aparece na página) e o objeto "validation", que contém status, razão e verificações relacionadas à precisão do valor extraído
Os dados da resposta estão organizados em duas seções principais: "dados", que contém os campos extraídos, e "validação", que fornece informações sobre a precisão dos valores numéricos. Cada seção é claramente definida, permitindo fácil acesso tanto aos resultados quanto ao seu status de validação
O endpoint Extrair da Página pode recuperar qualquer dado baseado em texto, como preços, especificações ou disponibilidade O endpoint Extrair da Captura de Tela é projetado para dados visuais que requerem renderização, como gráficos ou conteúdo dinâmico de aplicativos com muito JavaScript
A precisão dos dados é mantida através de uma camada de validação que verifica os valores numéricos extraídos em relação ao texto da página, dados históricos e possíveis mudanças decimais Isso garante que os usuários recebam informações confiáveis com o status de validação indicando o nível de confiança nos dados
Casos de uso típicos incluem monitoramento de preços para commodities ou produtos análise de concorrentes extração de especificações de páginas de produtos e alimentação de dados verificados em sistemas de IA A API é versátil para diversas indústrias que necessitam de extração de dados em tempo real
Os usuários podem personalizar solicitações de dados 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, como "preço em USD" ou "disponibilidade", e incluir parâmetros como "expiration_seconds" para cache
As verificações de qualidade incluem a validação em relação ao texto da página para confirmar a presença de valores numéricos, comparações com dados históricos para consistência e verificações de deslocamentos decimais. O objeto de validação fornece percepções detalhadas sobre as verificações realizadas, aprimorando a confiabilidade dos dados