Vindur Developer Docs

Public API and Agent Discovery

Vindur provides keyless public endpoints for reading quiet nature sanctuary summaries, coordinates, silence ratings and canonical URLs.

Quickstart

curl "https://vindur.app/api/spots?limit=10"
curl "https://vindur.app/api/search?q=orman"
curl "https://vindur.app/ask?q=sakin%20piknik%20oner"
curl -N "https://vindur.app/ask?q=sakin%20piknik%20oner&stream=true"

Agent Recovery

Public API limit is 120 requests per minute. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-Id. Retry 429 and temporary 5xx with exponential backoff starting at 2 seconds and stop after 3 attempts.

POST /ask and POST /api/batch accept Idempotency-Key. Sandbox: GET /api/sandbox/spots. Versioned aliases: /api/v1/spots and /api/v1/search.

Resources

• API Reference
• OpenAPI JSON
• Authentication notes
• Agent instructions
• API catalog
• MCP server card
• Webhook capability and signature docs
• Sandbox docs

Authentication

Public read endpoints require no API key, no OAuth token and no paid account. Private user profiles and admin surfaces are not exposed.