Modos

Cada endpoint de búsqueda acepta un mode. Define cuántas candidatas se juzgan y si las mejores se abren y se leen antes de ordenarlas.

normal es el modo por defecto. Los titulares ya juzgados para tu consulta no cuentan para esos límites ni se vuelven a pagar.

ultra es el modo más barato. Frente a la lista de Exa, revisada el 25 de septiembre de 2026: ultra cuesta 7× menos que una búsqueda de Exa ($7, que incluye el texto de hasta 10 resultados) y fast 5× menos, normal 3,1× menos que esa misma búsqueda y deep 2,1× menos que una búsqueda profunda de Exa ($12–15). Para buscar sólo titulares, la Fast Search de Perplexity ($1 cada 1.000 pedidos de hasta 5 consultas) y la búsqueda fast de Parallel ($1) cuestan lo mismo que ultra y menos que fast. Todas las comparaciones, modo por modo y con su fuente, están en la página de precios.

Cómo elegir

• ultra juzga sólo el titular y es el más barato. Úsalo para clasificar en volumen, alertas y todo lo que el titular ya dice.
• fast es el mejor punto de partida para agentes que buscan en bucle: rápido, barato y con buena cobertura cuando el titular nombra el tema.
• normal lee los mejores resultados antes de ordenarlos. Úsalo cuando un resultado equivocado sale caro: un titular que promete más que su nota se detecta y pasa a rejected.
• deep amplía el tema con sinónimos y términos relacionados, juzga más titulares y lee más notas, con fragmentos y lo esencial incluidos. Úsalo para investigar, armar informes y preguntas donde necesitas todo.

Cuando el índice no alcanza

Si el índice da menos de 3 resultados buenos, typesearch busca fuentes fuera de él, con un presupuesto de tiempo: como mucho 0,8 s más en ultra y fast (lo demás sigue en segundo plano y la próxima búsqueda lo aprovecha), 3 s en normal y 8 s en deep, que además puede usar el buscador de los sitios que propone.

Las fuentes las proponen un modelo que entiende el tema de tu consulta y un índice abierto de titulares de todo el mundo construido con datos del GDELT Project. Las notas se leen siempre en el sitio original, respetando su robots.txt, y las juzga el mismo modelo de relevancia. No interviene ningún buscador de terceros.

Lo que se encuentra así llega con found_in: "discovery", y la respuesta cuenta qué pasó en discovery (used, background, skipped, budget o timeout). Si se acabó el tiempo, incomplete es true: repetir la búsqueda un rato después suele traer más.

Los resultados llegan en dos tiempos

En cualquier modo, lo juzgado por titular llega primero —a más o menos un segundo— y cada resultado se confirma en su lugar a medida que se lee su nota. Con streaming recibes esos resultados parciales como eventos partial; sin él, recibes el resultado final.

Lo que no se paga dos veces

• Memoria de juicios. Lo que el modelo ya dijo de un titular para una consulta se reusa durante una semana: una búsqueda repetida o parecida sólo paga lo nuevo.
• Caché de resultados. Un pedido idéntico dentro de los 10 minutos sale de la caché: usage.tokens es 0 y no se cobra.

Mira Costos y caché para poner topes por pedido.