{"openapi":"3.1.0","info":{"title":"IMDB Service","version":"0.1.0"},"paths":{"/search":{"get":{"summary":"Search","description":"Return a filtered list of IMDb IDs matching the given criteria.","operationId":"search_search_get","parameters":[{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"type.not","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type.Not"}},{"name":"genre","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genre"}},{"name":"genre.any","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genre.Any"}},{"name":"genre.not","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genre.Not"}},{"name":"rating.gte","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating.Gte"}},{"name":"rating.lte","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating.Lte"}},{"name":"votes.gte","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes.Gte"}},{"name":"votes.lte","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes.Lte"}},{"name":"runtime.gte","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Runtime.Gte"}},{"name":"runtime.lte","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Runtime.Lte"}},{"name":"release.after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release.After"}},{"name":"release.before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release.Before"}},{"name":"title","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},{"name":"adult","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Adult"}},{"name":"imdb_top","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Imdb Top"}},{"name":"imdb_bottom","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Imdb Bottom"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"rating.desc","title":"Sort By"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"default":100,"title":"Limit"}},{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"}},{"name":"language.any","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language.Any"}},{"name":"language.not","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language.Not"}},{"name":"language.primary","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language.Primary"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"country.any","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country.Any"}},{"name":"country.not","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country.Not"}},{"name":"country.origin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country.Origin"}},{"name":"cast","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cast"}},{"name":"cast.any","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cast.Any"}},{"name":"cast.not","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cast.Not"}},{"name":"series","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Series"}},{"name":"series.not","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Series.Not"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Root","description":"Return HTML landing page with links to available endpoints.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/stats":{"get":{"summary":"Get Stats","description":"Return service health: status, phase, progress indicators, and per-table row counts.","operationId":"get_stats_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Stats Stats Get"}}}}}}},"/ratings/{imdb_id}":{"get":{"summary":"Get Ratings","description":"Return the IMDb rating metadata for a single title.","operationId":"get_ratings_ratings__imdb_id__get","parameters":[{"name":"imdb_id","in":"path","required":true,"schema":{"type":"string","title":"Imdb Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Ratings Ratings  Imdb Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/genre/{imdb_id}":{"get":{"summary":"Get Genres","description":"Return the IMDb genres for a single title.","operationId":"get_genres_genre__imdb_id__get","parameters":[{"name":"imdb_id","in":"path","required":true,"schema":{"type":"string","title":"Imdb Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Genres Genre  Imdb Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/parental/{imdb_id}":{"get":{"summary":"Get Parental Guide","description":"Return cached IMDb parental-guide labels for a title, refreshing when stale.","operationId":"get_parental_guide_parental__imdb_id__get","parameters":[{"name":"imdb_id","in":"path","required":true,"schema":{"type":"string","title":"Imdb Id"}},{"name":"ignore_cache","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Ignore Cache"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Parental Guide Parental  Imdb Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/title/{imdb_id}":{"get":{"summary":"Get Title","description":"Return full title record by IMDb ID (e.g. tt0111161).","operationId":"get_title_title__imdb_id__get","parameters":[{"name":"imdb_id","in":"path","required":true,"schema":{"type":"string","title":"Imdb Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Title Title  Imdb Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chart/{chart_name}":{"get":{"summary":"Get Chart","description":"Return a pre-computed ranked chart of IMDb titles.","operationId":"get_chart_chart__chart_name__get","parameters":[{"name":"chart_name","in":"path","required":true,"schema":{"type":"string","title":"Chart Name"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Chart Chart  Chart Name  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/person/{imdb_id}":{"get":{"summary":"Get Person","description":"Return person record by IMDb person ID (e.g. nm0000093).","operationId":"get_person_person__imdb_id__get","parameters":[{"name":"imdb_id","in":"path","required":true,"schema":{"type":"string","title":"Imdb Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Person Person  Imdb Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"/imdb-service"}]}