Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.topsort.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 /topsort_prompts/chat

​
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://mcp-server.api.topsort.ai/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