Documentación técnica de las APIs de búsqueda y fetch de DeepSeek

Fuentes: DeepSeek Search and Fetch API Technical Documentation

DeepSeek ha publicado la documentación técnica para sus APIs de búsqueda y fetch, diseñadas para permitir que agentes de IA y aplicaciones RAG accedan a contenido web en tiempo real. Estas herramientas, que operan como APIs JSON crudas, ofrecen dos funcionalidades principales: la API de búsqueda, impulsada por el motor de búsqueda interno de la empresa, que devuelve resultados estructurados para consultas complejas, y la API de fetch, que recupera el contenido de una página web específica y lo devuelve en formato Markdown.

Ambas APIs utilizan autenticación por token (Bearer) y comparten la misma base URL, https://api.deepseek.com. La API de búsqueda permite filtrar resultados mediante operadores de consulta avanzados, como restricciones por sitio web, idioma, fecha de publicación y exclusión de términos específicos. Los campos de solicitud incluyen la consulta, el número de resultados deseado (entre 1 y 50) y una opción para incluir el contenido completo de la página. La respuesta incluye una puntuación de relevancia, el título, la URL, un resumen y el contenido extraído, con un campo de autoridad que indica la fiabilidad de la fuente.

La API de fetch es más simple, requiriendo únicamente la URL de destino, que debe ser un enlace HTTP/HTTPS válido y no superar los 8192 caracteres. El resultado es el título y el contenido Markdown de la página. Ambas APIs son de solo lectura y gestionan errores mediante códigos HTTP estándar, como 401 para claves inválidas o 404 para páginas no accesibles. La documentación detalla los esquemas de solicitud y respuesta, así como las políticas de facturación y límites de tasa de solicitudes por segundo (QPS), proporcionando a los desarrolladores una guía completa para integrar estas herramientas en sus flujos de trabajo de inteligencia artificial.