{"openapi":"3.1.0","info":{"title":"IfLiked Search API","version":"1.0.0","description":"Public, unauthenticated movie recommendation search. Send a title or vibe; receive ranked movies with TMDB metadata. Rate-limited per IP (40 requests per minute). The homepage also exposes WebMCP tools (`search_movies`, `get_site_info`, optional `fill_search`) via `document.modelContext.registerTool` for capable in-browser agents—see /llms.txt."},"servers":[{"url":"https://ifliked.com"}],"paths":{"/api/search":{"get":{"operationId":"searchMovies","summary":"Recommend movies for a vibe or title","description":"Returns up to ~30 ranked movies for the given vibe string. Empty `movies` on invalid input, errors, or rate limiting (HTTP 429).","parameters":[{"name":"vibe","in":"query","required":true,"description":"Movie title, genre, mood, or free-text vibe (2–180 characters after trim).","schema":{"type":"string","minLength":2,"maxLength":180},"examples":{"comedy":{"value":"cozy rainy day comedy"},"title":{"value":"Parasite"}}}],"responses":{"200":{"description":"Ranked recommendations (possibly empty).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"429":{"description":"Rate limit exceeded; body is an empty result set.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}}}}}},"components":{"schemas":{"SearchResponse":{"type":"object","required":["movies"],"properties":{"movies":{"type":"array","items":{"$ref":"#/components/schemas/MovieCard"}}}},"MovieCard":{"type":"object","required":["id","title","year","posterUrl","overview"],"properties":{"id":{"type":"integer","description":"TMDB movie id."},"title":{"type":"string"},"year":{"type":["string","null"],"description":"Release year if known."},"posterUrl":{"type":["string","null"],"format":"uri","description":"TMDB poster image URL."},"overview":{"type":"string","description":"Plot overview from TMDB (not generated)."}}}}},"tags":[{"name":"search","description":"Vibe-based movie recommendations"}],"externalDocs":{"description":"IfLiked llms.txt","url":"https://ifliked.com/llms.txt"}}