Saltar al contenido principal

​
Opciones de integración

  • Agent API: ideal para chat y conversaciones multi-turno
  • MCP Server: ideal para integraciones personalizadas y acceso directo a herramientas

​
Opción 1: Agent API

​
Endpoint

POST /catalog/search

​
Headers

X-API-Key: YOUR_API_KEY
Content-Type: application/json

​
Request de ejemplo

{
  "query": "I need running shoes under $150",
  "session_id": "user-session-123",
  "max_results": 10,
  "max_sponsored": 3,
  "streaming": false
}
Campos clave: query, session_id, max_results, max_sponsored, streaming.

​
Opción 2: MCP Server

​
Conexión

URL: https://your-mcp-server.example.com/mcp
Transport: Streamable HTTP

X-API-Key: YOUR_API_KEY
Usa la herramienta search_products con parámetros como query, max_results y max_sponsored.

​
Buenas prácticas

  • Etiqueta claramente productos patrocinados (is_sponsored: true)
  • Rastrea resolvedBidId para atribución
  • Reutiliza session_id para mantener contexto conversacional
  • Implementa retries con backoff para errores 5xx