SearchLive

Movie Database API

Finds movies or TV shows by title, with optional year and region, and returns release year, poster, overview, and language.

$0.0115USDC per call · settled on Base · no subscription, no API key

Overview

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.

Endpoint

MethodEndpointPriceDescription
POST/v1/marketplace/api/movie-database$0.0115Invoke Movie Database (Search) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i -X POST https://jarvisclaw.ai/v1/marketplace/api/movie-database \
  -H 'Content-Type: application/json' \
  -d '{}'

# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://jarvisclaw.ai/v1/marketplace/api/movie-database \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <signed-payload>' \
  -d '{}'

Parameters

Taken from the request example this API publishes.

NameInTypeExample
include_providersbodybooleantrue
limitbodynumber3
querybodystring"Dune Part Two"
regionbodystring"US"
typebodystring"movie"
yearbodynumber2024

Example response

{
  "query": "Dune Part Two",
  "returned": 1,
  "top_match": {
    "tmdb_id": 693134,
    "type": "movie",
    "title": "Dune: Part Two",
    "release_year": 2024,
    "vote_average": 8.1
  },
  "provider_summary_for_top_match": {
    "region": "US",
    "flatrate": [
      {
        "name": "Max"
      }
    ],
    "rent": [
      {
        "name": "Amazon Video"
      }
    ]
  },
  "attribution": "Data: TMDB (https://www.themoviedb.org). Watch-provider data from JustWatch where included."
}

FAQ

How much does the Movie Database API cost?

$0.0115 USDC per call, paid per call over x402. There is no subscription, minimum or monthly fee.

Do I need an API key?

No. Call the endpoint, read the 402 Payment Required quote, and repeat the request with a signed USDC payment header. An account API key also works if you prefer prepaid billing.

Which chains can I pay on?

USDC on Base or on Solana. The 402 quote lists the accepted networks and the exact amount; the JarvisClaw SDKs sign and retry for you.

How do I call it from an AI agent?

Send POST to the endpoint above from any HTTP client, or connect the JarvisClaw MCP server and let the agent find and call it with the search_apis and get_api_detail tools.

Related APIs

Open in the marketplace

Docs: Getting started · x402 payments · x402 discovery · All APIs