Surfable

Documentation

Search our documentation below or browse the API reference.

API Reference

Full endpoint documentation for integrating Surfable:

POST/auth/register
POST/auth/login
POST/ingest
GET/ingest/:jobId
POST/search
POST/rag
POST/rag/stream

Common Questions

How does semantic search differ from keyword search?

Keyword search looks for exact word matches. Semantic search uses vector embeddings to understand the meaning behind a query, allowing it to find relevant content even if the exact words don't match.

What models do you use for generation?

By default, Surfable uses Gemini 2.0 Flash for fast, accurate generation and text-embedding-004 for high-quality semantic retrieval.