A Context API extrai o contexto completo de qualquer página web

Utilize a Perplexity Context API para fornecer a agentes de IA Markdown limpo, links e passagens relevantes de páginas web em cache ou em tempo real.

Context API artwork with a luminous mineral cross-section and geometric lines.

Quando alguém faz uma pergunta a um chatbot, um agente de IA pode ter de ler várias páginas web para responder. Os resultados de pesquisa habituais devolvem muitas vezes apenas excertos. Obter uma página diretamente pode devolver HTML em bruto, repleto de elementos de navegação, avisos de cookies e anúncios. Os agentes precisam do contexto da página num formato que um modelo consiga utilizar, enquanto os programadores precisam de uma forma de controlar quão atualizado esse contexto tem de ser.

Hoje lançamos a Perplexity Context API, que lê até 10 URLs e devolve markdown limpo, HTML, links e excertos baseados na consulta para cada página. A informação provém do vasto índice web da Perplexity ou de uma obtenção em tempo real. Os agentes podem especificar a atualidade de cada pedido e validar a fonte de cada resultado.

A Context API suporta vários formatos

Os agentes podem iniciar um pedido fornecendo uma lista de URLs e especificando os formatos de saída. A API devolve um resultado para cada URL, pela mesma ordem.

A Context API suporta vários formatos de resposta:

  • Markdown: O conteúdo da página em Markdown limpo, pronto a colocar no contexto de um modelo.
  • HTML: O HTML da página, para aplicações que fazem a sua própria análise.
  • Links: Os links da página como URLs absolutos, sem duplicados e pela ordem em que surgem na página, para que um agente possa decidir para onde ir a seguir.
  • Excertos: As passagens da página mais relevantes para uma consulta fornecida, dentro do limite de tokens definido pelo programador para cada página.

A Context API seleciona de cada página as passagens relevantes para a consulta, em vez de gerar um resumo. Assim, o modelo recebe a redação original da página, mas apenas as passagens selecionadas, pelo que há menos texto para processar.

Cada resultado bem-sucedido inclui também metadados como o título, a descrição, o idioma, o autor e a data de publicação, além das etiquetas Open Graph da página. Para criar o Markdown, a Context API divide a página em blocos e um modelo classifica cada bloco como conteúdo principal ou conteúdo acessório. Apenas os blocos de conteúdo são mantidos.

Essencial para tarefas que exigem uma visão completa

Encontrar uma página relevante nem sempre basta para concluir um trabalho. Com a Context API, os agentes podem obter o conteúdo de que precisam a partir de URLs selecionados para concluir tarefas complexas.

  • Implementar uma integração de API: Um resultado de pesquisa pode identificar a documentação certa sem incluir os parâmetros necessários, as instruções de autenticação ou os casos de erro. A Context API pode ajudar um agente de programação a obter a documentação e as referências da API para escrever uma integração com base nesses detalhes.
  • Comparar preços atuais: Um preço anunciado pode depender de limites de utilização, condições de faturação ou requisitos de elegibilidade que não constam de um excerto de pesquisa. Um agente pode pedir uma obtenção em tempo real de páginas de preços selecionadas e ler essas condições antes de fazer uma comparação.
  • Responder a perguntas sobre políticas: Um excerto de uma política de devoluções pode indicar o prazo de devolução habitual, mas omitir exceções para determinados produtos ou regiões. Um agente de apoio ao cliente pode obter a página da política para que a sua resposta tenha em conta essas exceções.
  • Pesquisar em várias fontes: Um excerto de pesquisa pode revelar uma conclusão sem a metodologia, as ressalvas ou a argumentação envolvente. Um agente de pesquisa pode obter os artigos e relatórios selecionados e, depois, comparar as provas em vez de depender apenas de excertos.

Controle a atualidade e processe URLs de forma fiável

Por predefinição, a Context API verifica primeiro o índice web da Perplexity em busca de uma cópia da página obtida nos últimos dois dias. Se não existir, obtém a página em tempo real. Os programadores podem alterar max_age_seconds para 0 para lerem sempre as páginas em tempo real, no caso de preços, resultados desportivos e notícias de última hora. Para material de referência que raramente muda, podem aumentar esse valor. Defina cache_only como true para cargas de trabalho que nunca devam acionar um pedido em tempo real.

Cada resultado regista se o conteúdo veio de uma cópia armazenada ou de uma obtenção em tempo real, e quando foi obtido.

Os URLs de um pedido são obtidos em paralelo, cada um com o seu próprio limite de tempo e o seu próprio estado. Uma página lenta ou com erros não faz falhar as restantes. O estado indica o que aconteceu com cada URL, para que um agente possa repetir apenas as páginas que excederam o tempo limite e manter as restantes.

A Context API devolve conteúdo utilizável e completo

Testámos a Context API em comparação com Firecrawl, Exa, Parallel, Keenable e Context.dev em 1000 URLs selecionados por amostragem a partir de pedidos reais de obtenção feitos por agentes. O conjunto abrange 715 sites e inclui fontes governamentais e académicas, bem como páginas noutras línguas que não o inglês. Em seguida, um modelo avaliador independente pontuou os resultados sem saber que fornecedor produziu cada um.

O gráfico mede o desempenho segundo três critérios:

  • Utilizável: A percentagem de URLs que devolveram o conteúdo real da página, e não uma página de erro ou um resultado vazio.
  • Recuperação de factos: O avaliador reúne os factos principais encontrados numa página em todos os fornecedores e, depois, verifica quais deles constam de cada resultado. Uma obtenção falhada tem pontuação zero.
  • Precisão do conteúdo: a proporção do texto devolvido que corresponde a conteúdo da página, e não a avisos de cookies, navegação ou anúncios, calculada em média para todos os URL. Se a obtenção falhar, a pontuação é zero.

Nesta avaliação, a Context API devolveu conteúdo utilizável para 92,3% dos URL, recuperou 87,9% dos factos principais e obteve 80,3% na precisão do conteúdo.

Preços

A Context API custa 1 $ por cada 1000 URLs obtidos. Os programadores pagam por cada URL que devolve ok. Os URLs que falham não são faturados.

Primeiros passos

bash
curl --request POST https://api.perplexity.ai/v1/context \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"], "formats": ["markdown"] }'

Cada resultado é devolvido com o Markdown da página, as passagens que correspondem à consulta, os metadados da página e um estado. Verifique o estado de cada resultado antes de utilizar o respetivo conteúdo.

Leia a documentação da Context API ou consulte a referência da API.

  1. Orchestrator: Uma API para inferência fiávelProgramadores17/11/2026
  2. Apresentamos a Monitor API da PerplexityProgramadores16/11/2026