Skip to main content
POST /v1/search
Run a natural-language search query. Results are ranked by semantic relevance, not just keyword matching.
​
query
string
required
Natural language search query
​
limit
integer
Max results (default 10, max 50)
​
from
string
Start date filter (ISO 8601)
​
to
string
End date filter (ISO 8601)
Request
curl -X POST https://api.ruune.ai/v1/search \
  -H "Authorization: Bearer ruune_sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query": "What did Sarah say about the API launch timeline?"}'
Response
{
  "results": [
    {
      "note_id": "note_abc123",
      "title": "Product Sync with Sarah",
      "snippet": "...we should prioritize the API launch and aim for end of Q3...",
      "relevance": 0.94,
      "created_at": "2026-06-15T14:30:00Z"
    },
    {
      "note_id": "note_def456",
      "title": "Team Standup — June 12",
      "snippet": "...Sarah mentioned the API docs need to be ready by July...",
      "relevance": 0.81,
      "created_at": "2026-06-12T09:00:00Z"
    }
  ]
}

​
Search Tips

  • Use natural language — “What did we decide about pricing?” works better than keyword searches.
  • Date filters narrow results to specific time ranges.
  • The snippet field shows the most relevant excerpt with your query terms in context.
  • Relevance scores range from 0.0 to 1.0. Results below 0.5 are typically not shown.