# AgentUtility Movie & TV Database Lookup

> AgentUtility Movie & TV Database Lookup is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: POST https://x402.agentutility.ai/movie-database
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-movie-tv-database-lookup-5a08ce2d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Da6y12XsO4T28lsgHKPHn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentutility-movie-tv-database-lookup-5a08ce2d -d '<json body>'
```

Example prompt: Can you look up the movie 'Inception' (2010) for me — I need the poster, overview, rating, and any streaming providers available in the US?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
           }
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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"
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-movie-tv-database-lookup-5a08ce2d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)