API

Authentication

Generate a key from your verified account and send it in the X-API-Key header. Keep it out of URLs and public code.

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

Agents can also pay per call with x402 when enabled. The 402 response and PAYMENT-REQUIRED header specify amount, asset and network; retry with PAYMENT-SIGNATURE. Do not assume mainnet availability or a fixed price.

Endpoints

• GET /v1/search?q=…&lang=es&limit=20&offset=0 — Paginated search: 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} — Entities, mentions and claims linked to public videos.

summary may be null; transcript and chapters may be empty. Derive the source URL (source_url) from video.youtube_id: https://www.youtube.com/watch?v={youtube_id}. Topics are entities rather than a separate topics field.

OpenAPI JSON · Interactive reference

Retrieve a real response

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

Use a result’s youtube_id to retrieve its summary, transcript and quotes at /v1/videos/{youtube_id}.

Real response without an API key

Requested on October 18, 2026 from GET /v1/search?q=bitcoin&lang=en&limit=1 without X-API-Key. The server returns HTTP 401:

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

To retrieve catalog results, repeat the query above with a valid account key or complete x402 payment when enabled.

Use cases

• Agent research: retrieve summaries and chapters before inspecting the full source.
• Topic or channel alerts: query search and filter results in your integration.
• Knowledge-base ingestion: index summaries and transcripts while retaining the video link.