Saltar al contenido principal
taskType selecciona el motor. Todas las tareas se envían igual y todos los resultados vuelven en el mismo objeto de resultado. Solo cambia de un motor a otro el objeto response que contiene.

Lo que comparten todas las tareas

GET /v1/async/task/{id} devuelve el mismo objeto de resultado para todos los motores: success, task (id, estado y metadatos), credits y, cuando la tarea termina, response o error. Consulta Tareas asíncronas para el ciclo de vida y Webhooks para la entrega push. Todos los motores de respuesta ponen la respuesta en response.text y las páginas que citó en response.sources, un array de { position, url, label } más campos propios de cada motor. Google AI Overviews es la excepción: el resumen está en response.aioverview, dentro de un objeto de resultados de búsqueda.

Motores de respuesta

Búsqueda y datos web

COMMERCE_SERP: site obligatorio: amazon, walmart, target, ebay, aliexpress, google_shopping, sephora o ulta (US), coupang, oliveyoung, 11st, lotteon, musinsa o kurly (KR), rakuten, yahoo_shopping o qoo10 (JP), flipkart, myntra o nykaa (IN), o zalando (DE). query: obligatorio, de 1 a 500 caracteres. country: opcional, por defecto el país de la tienda. limit: entero opcional de 1 a 40, con 20 por defecto. COMMERCE_PRODUCT: url obligatorio: una página de producto de amazon, walmart, target, sephora o ulta (US), 11st, lotteon, musinsa, kurly o oliveyoung (KR), rakuten, yahoo_shopping o qoo10 (JP), flipkart, myntra o nykaa (IN), o zalando (DE), de hasta 2.048 caracteres. country: opcional, por defecto el país de la tienda. Los precios son por tarea completada. Créditos y límites explica las reservas, los cobros y los complementos.

Qué campo del payload se lee

Para los motores enumerados a continuación, la validación acepta una tarea que lleve prompt o query, de 1 a 100.000 caracteres (400 VALIDATION_ERROR en otro caso). Cada motor lee primero un campo y recurre al otro, así que una solicitud enviada con la otra clave igualmente se ejecuta:
  • CHATGPT, GEMINI, PERPLEXITY, COPILOT, BING_AIMODE, META_AI, QWEN, DOUBAO, BAIDU_WENXIN y BING_SEARCH leen prompt y después query.
  • GOOGLE, AIMODE, GOOGLE_SERP, GOOGLE_PLACES, GOOGLE_NEWS, NAVER_AI_BRIEF, NAVER_AI_TAB, NAVER_SERP, REDDIT y BAIDU_AI_SEARCH leen query y después prompt.
Si envías los dos, gana el campo que se lee primero. La columna Lee muestra el campo que documenta la página de cada motor.

Alias aceptados

Estos nombres se aceptan al enviar y se ejecutan como el taskType canónico. El código nuevo debe enviar el nombre canónico. Los motores privados se rechazan con 403 ENGINE_PRIVATE.

La lista en vivo

GET /v1/capabilities no necesita clave de API y devuelve cada taskType público con sus alias, endpoint, créditos, campos de entrada obligatorios y opcionales, si acepta location e include.html, su política de países y un payload de ejemplo mínimo. Se genera a partir del mismo código que aplica cada regla, así que úsalo para alimentar los selectores de motor y de país.
Consulta la referencia de la API para el esquema de respuesta.

Opciones de la solicitud