/agent es una API mágica que busca, navega y recopila datos incluso de los sitios web más complejos, encontrando datos en lugares de difícil acceso y descubriendo información en cualquier parte de internet. Consigue en pocos minutos lo que a una persona le llevaría muchas horas y deja obsoleto el scraping web tradicional.
Solo describe qué datos quieres y /agent se encarga del resto.
Vista previa de investigación: Agent está en acceso anticipado. Es de esperar que tenga algunos detalles por pulir. Mejorará significativamente con el tiempo. Comparte tus comentarios →
/extract y lo lleva más allá:
- No se requieren URL: Describe lo que necesitas mediante el parámetro
prompt. Las URL son opcionales. - Búsqueda profunda en la web: Busca y navega de forma autónoma, explorando en profundidad los sitios para encontrar tus datos
- Fiable y preciso: Funciona con una amplia variedad de consultas y casos de uso
- Más rápido: Procesa múltiples fuentes en paralelo para obtener resultados más rápidos
- Más económico: Agent es más rentable que
/extractpara casos de uso complejos
Uso de /agent
prompt. Describe simplemente qué datos quieres extraer. Para obtener salida estructurada, proporciona un esquema JSON. Los SDK son compatibles con Pydantic (Python) y Zod (Node) para definiciones de esquemas con tipado seguro:
Respuesta
JSON
Proporcionar URLs (opcional)
Estado y finalización de trabajos
- Método predeterminado:
agent()espera y devuelve los resultados finales - Iniciar y luego consultar: Usa
start_agent(Python) ostartAgent(Node) para obtener un ID de trabajo de inmediato y luego consulta su estado conget_agent_status/getAgentStatus
Los resultados de los trabajos estarán disponibles durante 24 horas después de su finalización.
Posibles estados
| Estado | Descripción |
|---|---|
processing | El agente todavía está trabajando en tu solicitud |
completed | La extracción finalizó correctamente |
failed | Se produjo un error durante la extracción |
Ejemplo en estado pendiente
JSON
Ejemplo completado
JSON
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
prompt | string | Sí | Descripción en lenguaje natural de los datos que deseas extraer (máx. 10.000 caracteres) |
urls | array | No | Lista opcional de URLs en las que centrar la extracción |
schema | object | No | Esquema JSON opcional para una salida estructurada |
Agent vs Extract: Qué ha mejorado
| Característica | Agent (nuevo) | Extract |
|---|---|---|
| URLs necesarias | No | Sí |
| Velocidad | Más rápida | Estándar |
| Costo | Más bajo | Estándar |
| Fiabilidad | Más alta | Estándar |
| Flexibilidad de las consultas | Alta | Moderada |
Ejemplos de casos de uso
- Investigación: “Encuentra las 5 principales startups de IA y sus montos de financiación”
- Análisis de la competencia: “Compara los planes de precios entre Slack y Microsoft Teams”
- Recopilación de datos: “Extrae información de contacto de sitios web de empresas”
- Resumen de contenido: “Resume las últimas entradas de blog sobre web scraping”
Referencia de la API
Precios
Cómo funcionan los precios de Agent
- Extracciones simples (como obtener información de contacto de una sola página) suelen usar menos créditos y cuestan menos
- Tareas de investigación complejas (como análisis de la competencia en múltiples dominios) usan más créditos, pero reflejan el esfuerzo total involucrado
- Uso transparente te muestra exactamente cuántos créditos consumió cada solicitud
- Conversión de créditos convierte automáticamente el uso de créditos del agente en créditos para una facturación sencilla
El uso de créditos varía según la complejidad de tu prompt, la cantidad de datos procesados y la estructura de la salida solicitada.
Primeros pasos
Gestión de costos
- Empieza con ejecuciones gratuitas: Usa tus 5 solicitudes gratuitas diarias para entender los precios
- Configura el parámetro
maxCredits: Limita tu gasto estableciendo un número máximo de créditos que estás dispuesto a usar - Optimiza los prompts: Los prompts más específicos suelen consumir menos créditos
- Supervisa tu uso: Haz seguimiento de tu consumo desde el panel
- Define expectativas: Las investigaciones complejas en múltiples dominios consumirán más créditos que las extracciones sencillas de una sola página
Los precios están sujetos a cambios a medida que pasamos de la Research Preview a la disponibilidad general. Los usuarios actuales recibirán aviso previo de cualquier actualización de precios.

