Get movie/TV recommendations

Stage 196: real trending or genre-filtered movie/TV titles — the same TMDB-first, OMDb-fallback logic (screenPicks.ts) /spin and /bracket's movie category already use. Omit genre for what's currently trending, or pass one to filter. tmdbUnavailable is true when TMDB itself is down and the (dormant-by-default) OMDb movie-only fallback served the results instead. Every title returned here is TMDB's own catalog data (TMDB's trending/genre endpoints include real TV titles, not just movies) — this endpoint never returns TVmaze-sourced titles, which this app only ever adds client-side in the browser (Stage 168). Each title carries a detailUrl to a real, permanent LocalSelections page when it's TMDB-sourced with enough real overview text to index (null otherwise — see the TrendingTitle schema). Requires the movies scope. Costs 1 unit of the key's rate-limit budget per call. Stage 198: a free-tier key is also separately capped at 150 calls/day to this endpoint specifically (see the 429 response) — commercial use is exempt.

post/movies

Request

  • Base URL: https://localselections.com/api/v1
  • URL: https://localselections.com/api/v1/movies
  • Auth: API key in header X-API-Key

Request body

genrestring

Optional genre filter, e.g. "Comedy", "Action", "Drama". Omit for trending.

Response

Trending or genre-filtered movie/TV titles.

tmdbUnavailableboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.