API

Autenticación

Genera una clave desde tu cuenta verificada y envíala en la cabecera X-API-Key. Mantenla fuera de las URLs y del código público.

GET /v1/search?q=bitcoin&lang=en&limit=10
X-API-Key: YOUR_API_KEY

Los agentes también pueden pagar por llamada con x402 cuando esté habilitado. La respuesta 402 y la cabecera PAYMENT-REQUIRED indican importe, activo y red; reenvía la solicitud con PAYMENT-SIGNATURE. No presupongas disponibilidad en mainnet ni un precio fijo.

Endpoints

• GET /v1/search?q=…&lang=es&limit=20&offset=0 — Búsqueda paginada: items, total, limit, offset.
• GET /v1/videos/{youtube_id}?lang=es — video (title, channel), summary (tldr_md, chapters, alpha, provenance), transcript, entities, claims.
• GET /v1/entities/{slug} — Entidades, menciones y afirmaciones vinculadas a vídeos públicos.

summary puede ser null; transcript y chapters pueden estar vacíos. La URL de origen (source_url) se obtiene de video.youtube_id: https://www.youtube.com/watch?v={youtube_id}. Los temas (topics) aparecen como entidades, no como un campo topics separado.

OpenAPI JSON · Referencia interactiva

Consultar una respuesta real

curl --fail-with-body 'https://summaraise.com/v1/search?q=bitcoin&lang=en&limit=1' \
  -H 'X-API-Key: YOUR_API_KEY'

Usa el youtube_id de un resultado para consultar su resumen, transcripción y citas en /v1/videos/{youtube_id}.

Respuesta real sin clave API

Consulta realizada el 18 de octubre de 2026 a GET /v1/search?q=bitcoin&lang=en&limit=1 sin X-API-Key. El servidor devuelve HTTP 401:

{"detail":"Missing or malformed X-API-Key"}

Para obtener resultados del catálogo, repite la consulta anterior con una clave válida de tu cuenta o completa el pago x402 cuando esté habilitado.

Casos de uso

• Investigación con agentes: recuperar el resumen y los capítulos antes de abrir la fuente completa.
• Alertas por tema o canal: consultar la búsqueda y filtrar resultados en tu integración.
• Ingesta en una base de conocimiento: indexar resúmenes y transcripciones conservando el enlace al vídeo.