Context API extrae el contexto completo de cualquier página web

Usa Perplexity Context API para proporcionar a los agentes de IA Markdown limpio, enlaces y pasajes relevantes de páginas web en caché o en tiempo real.

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

Cuando alguien le hace una pregunta a un chatbot, es posible que un agente de IA necesite leer varias páginas web para responderla. Los resultados de búsqueda estándar a menudo devuelven solo fragmentos. Obtener una página directamente puede devolver HTML sin procesar, lleno de menús de navegación, avisos de cookies y anuncios. Los agentes necesitan el contexto de la página en un formato que un modelo pueda usar, mientras que los desarrolladores necesitan una forma de controlar qué tan reciente debe ser ese contexto.

Hoy lanzamos Perplexity Context API, que lee hasta 10 URL y devuelve Markdown limpio, HTML, enlaces y fragmentos basados en consultas para cada página. La información proviene del vasto índice web de Perplexity o de una obtención en tiempo real. Los agentes pueden especificar la actualidad de cada solicitud y validar la fuente de cada resultado.

Context API admite diversos formatos

Los agentes pueden iniciar una solicitud proporcionando una lista de URL y especificando los formatos de salida. La API devuelve un resultado para cada URL en el mismo orden.

Context API admite diversos formatos de respuesta:

  • Markdown: El contenido de la página en Markdown limpio, listo para incluirse en el contexto de un modelo.
  • HTML: El HTML de la página, para aplicaciones que realizan su propio análisis.
  • Enlaces: Los enlaces de la página como URL absolutas, sin duplicados y en el orden en que aparecen, para que un agente pueda decidir a dónde ir después.
  • Fragmentos: Los pasajes de la página más relevantes para la consulta proporcionada, dentro del límite de tokens que el desarrollador establezca para cada página.

Context API selecciona de cada página los pasajes relevantes para la consulta, en lugar de generar un resumen. Así, el modelo recibe la redacción original de la página, pero solo los pasajes seleccionados, por lo que hay menos texto que procesar.

Cada resultado exitoso también incluye metadatos como el título, la descripción, el idioma, el autor y la fecha de publicación, además de las etiquetas Open Graph de la página. Para generar el Markdown, Context API divide la página en bloques y un modelo clasifica cada bloque como contenido principal o contenido repetitivo. Solo se conservan los bloques de contenido.

Esencial para tareas que requieren el panorama completo

Encontrar una página relevante no siempre basta para completar un trabajo. Con Context API, los agentes pueden obtener el contenido que necesitan de las URL seleccionadas para completar tareas complejas.

  • Implementar una integración de API: Un resultado de búsqueda puede identificar la documentación correcta sin incluir los parámetros requeridos, las instrucciones de autenticación ni los casos de error. Context API puede ayudar a un agente de programación a obtener la documentación y las referencias de la API para escribir una integración basada en esos detalles.
  • Comparar precios actuales: Un precio publicado puede depender de límites de uso, condiciones de facturación o requisitos de elegibilidad que no aparecen en un extracto de búsqueda. Un agente puede solicitar la obtención en tiempo real de páginas de precios seleccionadas y leer esas condiciones antes de hacer una comparación.
  • Responder preguntas sobre políticas: Un extracto de una política de devoluciones puede indicar el plazo estándar de devolución, pero omitir excepciones para ciertos productos o regiones. Un agente de soporte puede obtener la página de la política para que su respuesta tenga en cuenta esas excepciones.
  • Investigar en múltiples fuentes: Un extracto de búsqueda puede mostrar un hallazgo sin la metodología, las salvedades ni el argumento que lo rodea. Un agente de investigación puede obtener los artículos e informes seleccionados y luego comparar la evidencia en lugar de depender solo de extractos.

Controla la actualidad y gestiona las URL de forma confiable

De forma predeterminada, la Context API primero busca en el índice web de Perplexity una copia de la página obtenida en los últimos dos días. Si no la hay, obtiene la página en tiempo real. Los desarrolladores pueden cambiar max_age_seconds a 0 para leer siempre las páginas en tiempo real, en el caso de precios, marcadores y noticias de última hora. Para material de referencia que rara vez cambia, pueden aumentarlo. Establece cache_only en true para cargas de trabajo que nunca deban activar una solicitud en tiempo real.

Cada resultado registra si el contenido provino de una copia almacenada o de una obtención en tiempo real, y cuándo se obtuvo.

Las URL de una solicitud se obtienen en paralelo, cada una con su propio límite de tiempo y su propio estado. Una página lenta o con errores no hace que fallen las demás. El estado indica qué ocurrió con cada URL, para que un agente pueda reintentar solo las páginas que agotaron el tiempo de espera y conservar el resto.

Context API devuelve contenido útil y completo

Probamos Context API frente a Firecrawl, Exa, Parallel, Keenable y Context.dev con 1,000 URL tomadas de solicitudes reales de obtención de agentes. El conjunto abarca 715 sitios e incluye fuentes gubernamentales y académicas, así como páginas en idiomas distintos del inglés. Después, un modelo evaluador independiente calificó los resultados sin saber qué proveedor había generado cada uno.

La gráfica mide el rendimiento según tres criterios:

  • Utilizable: La proporción de URL que devolvieron el contenido real de la página, no una página de error ni un resultado vacío.
  • Recuperación de hechos: El evaluador reúne los hechos clave encontrados en una página entre todos los proveedores y luego comprueba cuáles contiene cada resultado. Una obtención fallida obtiene una puntuación de cero.
  • Precisión del contenido: La proporción del texto devuelto que corresponde al contenido de la página, y no a avisos de cookies, navegación o anuncios, promediada entre todas las URL. Si la obtención falla, la puntuación es cero.

En esta evaluación, la Context API devolvió contenido utilizable para el 92.3 % de las URL, recuperó el 87.9 % de los datos clave y obtuvo un 80.3 % en precisión del contenido.

Precios

Context API cuesta 1 USD por cada 1,000 URL obtenidas. Los desarrolladores pagan por cada URL que devuelve ok. Las URL que fallan no se cobran.

Primeros pasos

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 incluye el Markdown de la página, los pasajes que coinciden con la consulta, los metadatos de la página y un estado. Revisa el estado de cada resultado antes de usar su contenido.

Lee la documentación de Context API o consulta la referencia de la API.

  1. Orchestrator: una API para una inferencia confiableDesarrolladores17 nov 2026
  2. Presentamos la Monitor API de PerplexityDesarrolladores16 nov 2026