agentutility(7)$ man movie-database
/movie-database
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
uncategorized
STATUS
● live
NAME
movie-database — movie database api / tv database api / film lookup / title metadata search / tmdb or wikidata movie lookup / movie ratings and popularity…
SYNOPSIS
POST https://x402.agentutility.ai/movie-database
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Movie database API / TV database API / film lookup / title metadata search / TMDB or Wikidata movie lookup / movie ratings and popularity when TMDB is configured / release year, poster, overview, language, and optional streaming provider summary. Finds movies or TV shows by title with optional year and region. Uses TMDB when TMDB_API_KEY is configured and falls back to no-key Wikidata metadata.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| query | string | Movie or TV title to search, e.g. 'Dune Part Two'. | required |
| type | string | Restrict results to movie, tv, or both. Default both. enum: movie · tv · both | optional |
| year | number | Optional release year filter. | optional |
| region | string | 2-letter provider region for optional provider summary. Default US. | optional |
| include_providers | boolean | If true, include watch-provider summary for the top match. | optional |
| limit | number | Max results to return, 1-10. Default 5. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| query | string | — |
| returned | string | — |
| top_match | string | — |
| provider_summary_for_top_match | string | — |
| attribution | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/movie-database \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the movie-database tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- mediakitmoviedatabasemovie-database
- methods
- POST
- cluster
- mediakit
- price
- $0.01 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| audio-transcribe | Audio transcribe / speech-to-text / Whisper-large / multi-language ASR / OpenAI Whisper API compat. | $0.01 |
| csv-to-ics | CSV to ICS / CSV to iCal / calendar file generator / .ics builder / Google Calendar + Outlook + Apple Calendar import. | $0.01 |
| image-convert | Universal image format converter (PNG, JPG, WEBP, AVIF, GIF, BMP, TIFF, ICO, HEIC, HEIF, PSD, SVG). | $0.01 |
| image-format-convert | Image converter. | $0.01 |
| merge-pdf | PDF merger / combine PDFs / concatenate PDF files / join multiple PDFs into one. | $0.01 |
| movie-database-api | Movie database API / TV database API / TMDB metadata lookup. | $0.01 |
| movie-database-api-0d6d62 | Movie database API / TV database API / OMDB-style movie lookup. | $0.01 |
| movie-info | Movie info API / film metadata lookup / TV metadata lookup. | $0.01 |
SEE ALSO