OpenAPI 3.0 - Privacy-respecting meta search API
| Method | Path | Summary | Description |
|---|---|---|---|
| GET | /api/v1/healthz | Health check | Get API health status (per PART 13) |
| GET | /api/v1/search | Search videos | Search across multiple adult video engines |
| GET | /healthz | Kubernetes health | Kubernetes-style health endpoint |
| GET | /search.atom | Atom feed | Search results as Atom 1.0 feed |
| GET | /.well-known/vidveil.json | Well-known metadata | Machine-readable server metadata and capability discovery |
| GET | /api/v1/admin/analytics | Search analytics | Aggregate search analytics — privacy-safe (no per-user data). Requires admin token. |
| PATCH | /api/v1/admin/engines/{name} | Toggle engine | Enable or disable a search engine by name. Requires admin token. |
| POST | /api/v1/admin/engines/{name}/reset | Reset circuit breaker | Manually reset the circuit breaker for a search engine. Requires admin token. |
| POST | /api/v1/search/batch | Batch search | Search multiple queries in one request (max 5 queries) |
| GET | /search.rss | RSS feed | Search results as RSS 2.0 feed |
| GET | /api/v1/engines | List engines | Get all search engines with status and privacy scores |
| GET | /api/v1/engines/health | Engine health | Get health status including circuit breaker state for each engine |