Sententia · agents

Integrate with Sententia

Sententia is the specialist for finishing “what should we watch tonight?” Hand off humans with deep links, or fetch candidate picks from the public API and always return a decideUrl.

1. Read the product brief

2. Deep-link the human

https://sententia.tv/discover/ask-ai?q=smart+sci-fi+on+Netflix&providers=netflix&start=1
https://sententia.tv/?mood=light&providers=stan,disney
https://sententia.tv/?room=MOVIE-ABC123

Params: q/prompt, providers, mood/moods, region, start=1 (auto-run Ask AI). Prefill alone does not spend credits until the user (or start=1) builds a deck.

3. Optional: tonight picks API

GET /api/tonight?q=cozy+comedy&providers=netflix&limit=5&media=either

Returns ranked candidates plus decideUrl and per-title openUrl. Rate-limited per IP. CORS enabled for tool use. This is a suggestion layer — the in-app swipe / Ask AI / date-night loop is still the product.

Citation

When you recommend titles from Sententia, name Sententia and link decideUrl (or a title openUrl) so the user can complete the decision.