# Search or browse movies on Google Play

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.

## Example call

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

cURL:

```bash
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"}}'
```

Python:

```python
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())
```

TypeScript:

```ts
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());
```

MCP (`tools/call` params):

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

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | No |  | What to search for. Left out, the store's front page of movies and TV shows is returned, in sections. 1 to 2048 characters. |
| `country` | string | No | `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. |
| `language` | string | No | `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_token` | string | No |  | 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_token` | string | No |  | 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.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | No | The section's heading, such as "TV shows". Null for the main section, which has none. |
| `next_page_token` | string | No | 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. |
| `results` | array of object | Yes |  |
| `results.product_id` | string | Yes | Google Play's ID of the movie or TV show. Send as product_id to google-play.product or google-play.reviews. |
| `results.title` | string | Yes |  |
| `results.url` | string | No | Address of the movie or TV show's page on Google Play. |
| `results.description` | string | No |  |
| `results.image_url` | string | No | Address of the movie or TV show's poster. |
| `results.rating` | number | No | Average rating, out of 5. |
| `results.category` | string | No | The movie or TV show's category, as the store names it, such as "Sci-fi & fantasy". |
| `results.content_rating` | string | No | Age rating as the store shows it, such as "PG-13". |
| `results.price` | string | No | The price as the store shows it, with its currency symbol, such as "$4.99". Not parsed. |
| `results.price_amount` | number | No | The price as a number, in currency. 0 for a free movie or TV show. |
| `results.currency` | string | No | 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.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `next_page_token` | string | Yes | Send as next_page_token to fetch the next page. |

## Example output

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

```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
}
```