Search or browse movies on Google Play

POST/v1/tools/google-play.search.movies/callsNeeds an API key

Returns the Google Play movies and TV shows that match a search, in the store's sections. Without a query, it returns the store's front page of them.

Tool google-play.search.movies on Google Play. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystring

What to search for. Left out, the store's front page of movies and TV shows is returned, in sections.

1 to 2048 characters.

countrystring· default us

Two-letter ISO 3166-1 country code of the storefront. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

languagestring· default en

Two-letter ISO 639-1 language code of the storefront. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

next_page_tokenstring

Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same query, country and language. Not with section_page_token.

section_page_tokenstring

Loads more of one section. Take it from that section's next_page_token, and send the same query, country and language. Not with next_page_token.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`sections`

A list of rows. Always present, possibly empty. The results, in the sections the store groups them in, in order.

titlestring

The section's heading, such as "TV shows". Null for the main section, which has none.

next_page_tokenstring

Send as section_page_token to load more of this section, with the same query, country and language. Null when the section has no more.

resultsarray of objectRequired

results.product_idstringRequired

Google Play's ID of the movie or TV show. Send as product_id to google-play.product or google-play.reviews.

results.titlestringRequired

results.urlstring

Address of the movie or TV show's page on Google Play.

results.descriptionstring

results.image_urlstring

Address of the movie or TV show's poster.

results.ratingnumber

Average rating, out of 5.

results.categorystring

The movie or TV show's category, as the store names it, such as "Sci-fi & fantasy".

results.content_ratingstring

Age rating as the store shows it, such as "PG-13".

results.pricestring

The price as the store shows it, with its currency symbol, such as "$4.99". Not parsed.

results.price_amountnumber

The price as a number, in currency. 0 for a free movie or TV show.

results.currencystring

Three-letter ISO 4217 currency code of price_amount.

`pagination`

One object. Can be null. How to fetch the next page. Null on the last page.

next_page_tokenstringRequired

Send as next_page_token to fetch the next page.

curl https://api.voxoria.ai/v1/tools/google-play.search.movies/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"dune"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google-play.search.movies/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"query": "dune"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/google-play.search.movies/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"query": "dune"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "google-play.search.movies",
    "input": {
      "query": "dune"
    }
  }
}

200 OKoutputapplication/json

{
  "sections": [
    {
      "title": "Movies",
      "next_page_token": "pt1.bGl0ZXNjcmFwZTpleUoySWpveExDSnZjR1Z5WVhScGIyNGlPaUp0YjNacFpYTWlMQ0pqYjI1MFpYaDBJanA3SW1oc0lqb2laVzRpTENKbmJDSTZJblZ6SWl3aWNTSTZJbVIxYm1VaWZTd2lhMmx1WkNJNkluTmxZM1JwYjI0aUxDSjBiMnRsYmlJNklrTm5halp1YjBka1FYZEpTVVpDUVZWSFp5MUxRV2QzUzBKSFVqRmliVlZSUW1oblFrbEJSV2RCUkc5UFEyZFpTMEpIVWpGaWJWVlJRVUpuUWtsQlVTSjk",
      "results": [
        {
          "product_id": "TyMZAc6Wbjo",
          "title": "Dune",
          "url": "https://play.google.com/store/movies/details/Dune?id=TyMZAc6Wbjo",
          "description": "The long-awaited film version of Frank Herbert's classic science fiction epic, Dune, explodes on the screen with dazzling special effects, unforgettable images and powerful performances. The saga of intergalactic warrior Paul Atreides (Kyle MacLachlan) and his messianic rise to leadership features an all-star cast, including Jose Ferrer, Max Von Sydow, Oscar-winner Linda Hunt and rock legend, Sting.",
          "image_url": "https://play-lh.googleusercontent.com/7zwFBMZPx3mwRQhBf1TV1FoE7dG8Tlfx3ck9QUGEHyhEHUDYKVJeRBT6kUratWVqrkFTyw",
          "rating": 4.4153566,
          "category": "Sci-fi & fantasy",
          "content_rating": "PG-13",
          "price": "$3.99",
          "price_amount": 3.99,
          "currency": "USD"
        },
        {
          "product_id": "BNGzBhWwmEE",
          "title": "Jodorowsky's Dune",
          "url": "https://play.google.com/store/movies/details/Jodorowsky_s_Dune?id=BNGzBhWwmEE",
          "description": "The tale of Jodorowsky and his Dune is a fascinating trip through creativity and imagination, a story about the relentless pursuit of a dream, and the necessity of art. In pre-production for over two years, the film was to star Jodorowsky's own 12-year-old son Brontis alongside Orson Welles, Mick Jagger, David Carradine and even Salvador Dali, set to a musical score by Pink Floyd and art-design by some of the most provocative talents of the era, including H.R. Giger and Jean 'Moebius' Giraud.",
          "image_url": "https://play-lh.googleusercontent.com/ObTv3d23hrCsxjxD7lAFWvSIUcCVwd47vshs50wpLDPFaRELanM-RDFtCzGWGwkrYA4mMQ",
          "rating": 4.335512,
          "category": "Documentary",
          "content_rating": "PG-13",
          "price": "$3.99",
          "price_amount": 3.99,
          "currency": "USD"
        },
        {
          "product_id": "3kZgt4zPUQM.P",
          "title": "Dune 2-Film Collection",
          "url": "https://play.google.com/store/movies/details/Dune_2_Film_Collection?id=3kZgt4zPUQM.P",
          "description": "Dune: A mythic and emotionally charged hero’s journey, “Dune” tells the story of Paul Atreides, a brilliant and gifted young man born into a great destiny beyond his understanding, who must travel to the most dangerous planet in the universe to ensure the future of his family and his people. As malevolent forces explode into conflict over the planet’s exclusive supply of the most precious resource in existence—a commodity capable of unlocking humanity’s greatest potential—only those who can conquer their fear will survive. Dune: Part 2: Explores the mythic journey of Paul Atreides as he unites with Chani and the Fremen while on a warpath of revenge against the conspirators who destroyed his family. Facing a choice between the love of his life and the fate of the known universe, he endeavors to prevent a terrible future only he can foresee.",
          "image_url": "https://play-lh.googleusercontent.com/KnSrgKY-OqjdD8kfsLiLoEoBxSqL8UTJGITbzUHyuP02aj8YihroGNUeI9dak4cYME1HeofctQQ223GlnSc",
          "rating": 1.8125,
          "category": "Sci-fi & fantasy",
          "content_rating": "PG-13",
          "price": "$26.99",
          "price_amount": 26.99,
          "currency": "USD"
        }
      ]
    },
    {
      "title": "TV shows",
      "next_page_token": null,
      "results": [
        {
          "product_id": "dfG5FqYlZhc.P",
          "title": "Dune: Prophecy",
          "url": "https://play.google.com/store/tv/show/Dune_Prophecy?id=dfG5FqYlZhc.P",
          "description": null,
          "image_url": "https://play-lh.googleusercontent.com/BKM3d12ZmoqbHkDcYpkxrGYTKhk1URUEwTlXVRWGC--cpqZagilIAw51QyMOSo7nAMHMjMA11WzeT5vU0rAg",
          "rating": null,
          "category": "Action & adventure",
          "content_rating": null,
          "price": null,
          "price_amount": null,
          "currency": null
        },
        {
          "product_id": "i2YtbASu6zc.P",
          "title": "Lady of the Dunes: Hunting a Cape Cod Killer",
          "url": "https://play.google.com/store/tv/show/Lady_of_the_Dunes_Hunting_a_Cape_Cod_Killer?id=i2YtbASu6zc.P",
          "description": null,
          "image_url": "https://play-lh.googleusercontent.com/HdC_0UUdpeHxov6hGFKOxNzTA29n0LIcri_-wp-RcQAe5aiFcQaFUD716njAZ6EuDyv4wkPV0bidqxoxk4Nx",
          "rating": null,
          "category": "Documentary",
          "content_rating": null,
          "price": null,
          "price_amount": null,
          "currency": null
        },
        {
          "product_id": "jvNOv4g1hYg.P",
          "title": "Black Snow",
          "url": "https://play.google.com/store/tv/show/Black_Snow?id=jvNOv4g1hYg.P",
          "description": null,
          "image_url": "https://play-lh.googleusercontent.com/T0b6QdjYTrehOgbbzmBCFWtXHeibBAZYBIgGdVFxnG9P72ur3-Ae1lo4Hy-Vh0dNiTvqaMe9tFKo_x0kwr8",
          "rating": null,
          "category": "Drama",
          "content_rating": "TV-MA",
          "price": null,
          "price_amount": null,
          "currency": null
        }
      ]
    },
    {
      "title": "TV episodes",
      "next_page_token": "pt1.bGl0ZXNjcmFwZTpleUoySWpveExDSnZjR1Z5WVhScGIyNGlPaUp0YjNacFpYTWlMQ0pqYjI1MFpYaDBJanA3SW1oc0lqb2laVzRpTENKbmJDSTZJblZ6SWl3aWNTSTZJbVIxYm1VaWZTd2lhMmx1WkNJNkluTmxZM1JwYjI0aUxDSjBiMnRsYmlJNklrTm5halp1YjBka1FYZEpTVVpDUVZWSFp5MUxRV2QzUzBKSFVqRmliVlZSUmtKblFrbEJSV2RCYW05UFEyZFpTMEpIVWpGaWJWVlJRVUpuUWtsQlVTSjk",
      "results": [
        {
          "product_id": "W7hUxtKChR0.P",
          "title": "The High-Handed Enemy",
          "url": "https://play.google.com/store/tv/show?id=dfG5FqYlZhc.P&cdid=tvseason-OVPad1njPzI.P&gdid=tvepisode-W7hUxtKChR0.P",
          "description": null,
          "image_url": "https://play-lh.googleusercontent.com/BKM3d12ZmoqbHkDcYpkxrGYTKhk1URUEwTlXVRWGC--cpqZagilIAw51QyMOSo7nAMHMjMA11WzeT5vU0rAg",
          "rating": null,
          "category": null,
          "content_rating": null,
          "price": "$3.99",
          "price_amount": 3.99,
          "currency": "USD"
        },
        {
          "product_id": "6ZtdEUNOPqY.P",
          "title": "In Blood, Truth",
          "url": "https://play.google.com/store/tv/show?id=dfG5FqYlZhc.P&cdid=tvseason-OVPad1njPzI.P&gdid=tvepisode-6ZtdEUNOPqY.P",
          "description": null,
          "image_url": "https://play-lh.googleusercontent.com/BKM3d12ZmoqbHkDcYpkxrGYTKhk1URUEwTlXVRWGC--cpqZagilIAw51QyMOSo7nAMHMjMA11WzeT5vU0rAg",
          "rating": null,
          "category": null,
          "content_rating": null,
          "price": "$3.99",
          "price_amount": 3.99,
          "currency": "USD"
        },
        {
          "product_id": "v2xPPbaavP0.P",
          "title": "Twice Born",
          "url": "https://play.google.com/store/tv/show?id=dfG5FqYlZhc.P&cdid=tvseason-OVPad1njPzI.P&gdid=tvepisode-v2xPPbaavP0.P",
          "description": null,
          "image_url": "https://play-lh.googleusercontent.com/BKM3d12ZmoqbHkDcYpkxrGYTKhk1URUEwTlXVRWGC--cpqZagilIAw51QyMOSo7nAMHMjMA11WzeT5vU0rAg",
          "rating": null,
          "category": null,
          "content_rating": null,
          "price": "$3.99",
          "price_amount": 3.99,
          "currency": "USD"
        }
      ]
    }
  ],
  "pagination": null
}

The output of a real call, each list cut to 3 items.