A Context API extrai o contexto completo de qualquer página da web
Use a Perplexity Context API para fornecer a agentes de IA Markdown limpo, links e passagens relevantes de páginas da web em cache ou em tempo real.

Quando alguém faz uma pergunta a um chatbot, um agente de IA pode precisar ler várias páginas da web para respondê-la. Os resultados de pesquisa padrão geralmente retornam apenas trechos. Buscar uma página diretamente pode retornar HTML bruto, cheio de menus de navegação, banners de cookies e anúncios. Os agentes precisam do contexto da página em um formato que um modelo possa usar, enquanto os desenvolvedores precisam de uma forma de controlar quão atualizado esse contexto deve ser.
Hoje estamos lançando a Perplexity Context API, que lê até 10 URLs e retorna markdown limpo, HTML, links e trechos baseados em consultas para cada página. As informações vêm do vasto índice da web da Perplexity ou de uma busca em tempo real. Os agentes podem especificar a atualidade de cada solicitação e validar a fonte de cada resultado.
A Context API oferece suporte a diversos formatos
Os agentes podem iniciar uma solicitação fornecendo uma lista de URLs e especificando os formatos de saída. A API retorna um resultado para cada URL, na mesma ordem.
A Context API oferece suporte a diversos formatos de resposta:
- Markdown: O conteúdo da página em Markdown limpo, pronto para ser inserido no contexto de um modelo.
- HTML: O HTML da página, para aplicativos que fazem a própria análise.
- Links: Os links da página como URLs absolutas, sem duplicatas e na ordem em que aparecem na página, para que um agente possa decidir para onde ir em seguida.
- Trechos: As passagens da página mais relevantes para a consulta fornecida, dentro do limite de tokens definido pelo desenvolvedor para cada página.
A Context API seleciona passagens de cada página que são relevantes para a consulta, em vez de gerar um resumo. Assim, o modelo recebe o texto original da página, mas apenas as passagens selecionadas, o que reduz a quantidade de texto a processar.
Todo resultado bem-sucedido também inclui metadados como título, descrição, idioma, autor e data de publicação, além das tags Open Graph da página. Para gerar o Markdown, a Context API divide a página em blocos, e um modelo classifica cada bloco como conteúdo principal ou texto genérico. 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 é suficiente para concluir um trabalho. Com a Context API, os agentes podem obter o conteúdo de que precisam a partir de URLs selecionadas 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 uso, condições de cobrança ou critérios de elegibilidade que não aparecem em um trecho de resultado de pesquisa. Um agente pode solicitar uma busca 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 trecho de uma política de devolução pode informar o prazo padrão de devolução, mas omitir exceções para determinados produtos ou regiões. Um agente de suporte pode obter a página da política para que sua resposta leve em conta essas exceções.
- Pesquisar em várias fontes: Um trecho de resultado de pesquisa pode revelar uma conclusão sem a metodologia, as ressalvas ou a argumentação em que ela se insere. Um agente de pesquisa pode obter os artigos e relatórios selecionados e, em seguida, comparar as evidências, em vez de depender apenas de trechos.
Controle a atualidade e processe URLs de forma confiável
Por padrão, a Context API primeiro verifica se o índice da web da Perplexity tem uma cópia da página obtida nos últimos dois dias. Se não houver, ela busca a página em tempo real. Os desenvolvedores podem alterar max_age_seconds para 0 para sempre ler as páginas em tempo real, no caso de preços, placares e notícias de última hora. Para materiais de referência que raramente mudam, eles podem aumentar esse valor. Defina cache_only como true para cargas de trabalho que nunca devem acionar uma solicitação em tempo real.
Cada resultado registra se o conteúdo veio de uma cópia armazenada ou de uma busca em tempo real, e quando ele foi obtido.
As URLs de uma solicitação são buscadas em paralelo, cada uma com seu próprio limite de tempo e seu próprio status. Uma página lenta ou com problemas não faz as outras falharem. O status indica o que aconteceu com cada URL, para que um agente possa tentar novamente apenas as páginas que excederam o tempo limite e manter o restante.
A Context API retorna conteúdo utilizável e completo
Testamos a Context API em comparação com Firecrawl, Exa, Parallel, Keenable e Context.dev em 1.000 URLs amostradas de solicitações reais de busca feitas por agentes. O conjunto abrange 715 sites e inclui fontes governamentais e acadêmicas, bem como páginas em idiomas que não o inglês. Em seguida, um modelo avaliador separado pontuou os resultados sem saber qual provedor havia produzido cada um.
O gráfico mede o desempenho com base em três critérios:
- Utilizável: A porcentagem de URLs que retornaram o conteúdo real da página, e não uma página de erro ou um resultado vazio.
- Recuperação de fatos: O avaliador reúne os principais fatos encontrados em uma página considerando todos os provedores e, em seguida, verifica quais deles cada resultado contém. Uma busca com falha recebe pontuação zero.
- Precisão de conteúdo: a proporção do texto retornado que é conteúdo da página, e não avisos de cookies, navegação ou anúncios, calculada como média de todas as URLs. Uma busca com falha recebe pontuação zero.
Nesta avaliação, a Context API retornou conteúdo utilizável para 92,3% das URLs, recuperou 87,9% dos fatos principais e obteve 80,3% em precisão de conteúdo.
Preços
A Context API custa US$ 1 a cada 1.000 URLs buscadas. Os desenvolvedores pagam por cada URL que retorna ok. URLs com falha não são cobradas.
Primeiros passos
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 inclui o Markdown da página, as passagens que correspondem à consulta, os metadados da página e um status. Verifique o status de cada resultado antes de usar seu conteúdo.
Leia a documentação da Context API ou consulte a referência da API.