{"uid":"cap_Da6y12XsO4T28lsgHKPHn","slug":"agentutility-movie-tv-database-lookup-5a08ce2d","name":"AgentUtility Movie & TV Database Lookup","description":"Finds movies or TV shows by title, with optional year and region, and returns release year, poster, overview, and language. Uses TMDB when TMDB_API_KEY is configured (adding movie ratings, popularity, and an optional streaming provider summary) and falls back to no-key Wikidata metadata otherwise. Use it as a movie database API, TV database API, film lookup, title metadata search, or TMDB / Wikidata movie lookup.","url":"https://x402.agentutility.ai/movie-database","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["query"],"properties":{"type":{"enum":["movie","tv","both"],"type":"string","description":"Restrict results to movie, tv, or both. Default both."},"year":{"type":"number","description":"Optional release year filter."},"limit":{"type":"number","description":"Max results to return, 1-10. Default 5."},"query":{"type":"string","description":"Movie or TV title to search, e.g. 'Dune Part Two'."},"region":{"type":"string","description":"2-letter provider region for optional provider summary. Default US."},"include_providers":{"type":"boolean","description":"If true, include watch-provider summary for the top match."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"query":{"type":"string"},"returned":{"type":"integer"},"top_match":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"tmdb_id":{"type":"integer"},"release_year":{"type":"integer"},"vote_average":{"type":"number"}}},"attribution":{"type":"string"},"provider_summary_for_top_match":{"type":"object","properties":{"rent":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}},"region":{"type":"string"},"flatrate":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}}}}}}}}}},"responseSchema":{"type":"json","example":{"query":"Dune Part Two","returned":1,"top_match":{"type":"movie","title":"Dune: Part Two","tmdb_id":693134,"release_year":2024,"vote_average":8.1},"attribution":"Data: TMDB (https://www.themoviedb.org). Watch-provider data from JustWatch where included.","provider_summary_for_top_match":{"rent":[{"name":"Amazon Video"}],"region":"US","flatrate":[{"name":"Max"}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sV6y3CdPFxVO-NxNyWu-0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up movies or TV shows by title (with optional year and region) and returns metadata including release year, poster, overview, language, ratings, popularity, and streaming provider info via TMDB or Wikidata fallback.","exampleAgentPrompt":"Can you look up the movie 'Inception' (2010) for me — I need the poster, overview, rating, and any streaming providers available in the US?","exampleUseCases":[{"title":"Movie recommendation card builder","prompt":"Pull up the metadata for 'The Grand Budapest Hotel' (2014) including its poster, overview, language, and TMDB rating so I can build a recommendation card for it."},{"title":"Streaming availability check","prompt":"I want to watch 'Severance' — can you find that TV show's details and tell me which streaming providers carry it in the UK?"},{"title":"Film release year verification","prompt":"I'm not sure exactly when 'Dune: Part Two' came out — can you look it up and give me the release year, a short overview, and the popularity score?"}],"resultDescription":"Returns a structured object containing the title's release year, poster image URL, plot overview, original language, and (when TMDB is configured) ratings, popularity score, and a summary of streaming providers available in the requested region.","failureModes":["Title not found in TMDB or Wikidata — returns empty or null result","Ambiguous title with multiple matches — may return the most popular or first match rather than intended film","TMDB_API_KEY not configured — falls back to Wikidata, losing ratings, popularity, and streaming provider data","Invalid region code — streaming provider summary may be unavailable or empty","Network timeout to upstream TMDB or Wikidata API — returns error response","Payment not settled via x402 — request rejected before processing"],"whenToPreferThis":"Use this endpoint when you need quick, structured metadata for a specific movie or TV show by title — especially when you want poster images, overviews, TMDB ratings, and streaming provider info in a single call. Prefer this over raw TMDB API integration when you want a pay-per-call model (no API key management needed) or when you need a graceful Wikidata fallback for less-known titles.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:23.766Z","isFirstParty":false}