{"uid":"cap_0FjCzCh4dAEqvw2tTCNm8","slug":"agentutility-movie-tv-database-api-d299b45b","name":"AgentUtility Movie & TV Database API","description":"Movie database API / TV database API / TMDB metadata lookup. Searches movies and TV shows by title and optional year, returning release date, rating, popularity, overview, poster URLs, TMDB links, and optional provider summary.","url":"https://x402.agentutility.ai/movie-database-api","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_9SgiCZbLIXbvmIaGZGZRR","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":"Searches movies and TV shows by title and optional year, returning metadata including release date, rating, popularity, overview, poster URLs, TMDB links, and an optional provider summary.","exampleAgentPrompt":"Can you look up the TMDB metadata for Inception (2010) — I need the release date, rating, popularity score, overview, and a poster URL?","exampleUseCases":[{"title":"Movie night recommendation enrichment","prompt":"I'm building a movie night recommendation list — can you fetch the TMDB metadata for The Dark Knight (2008), including its rating, overview, and poster URL?"},{"title":"TV show discovery details","prompt":"What are the TMDB details for Breaking Bad the TV show? I want the release date, rating, popularity, and a brief overview."},{"title":"Film release verification","prompt":"Can you verify the release year and get the TMDB rating and overview for Dune Part Two (2024)?"}],"resultDescription":"Returns structured metadata for the matched movie or TV show, including release date, audience rating, popularity score, plot overview, poster image URLs, a direct TMDB link, and optionally a provider-generated summary of the title.","failureModes":["Title not found in TMDB — returns empty results or error","Ambiguous title with no year provided — may return wrong match","Invalid or missing required title parameter — returns validation error","Payment failure via x402 — call rejected before execution","TMDB upstream unavailable — service returns error or timeout"],"whenToPreferThis":"Choose this endpoint when you need structured film or TV metadata (ratings, release dates, overviews, posters, TMDB links) for a specific title and optionally a year, especially in agentic workflows that require USDC micro-payment settlement via x402. Prefer it over scraping TMDB directly when you need a simple, agent-callable, pay-per-use API without managing TMDB API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:51:30.696Z","isFirstParty":false}