Sign In Register

Google Play Movies Store API

API uptime
100.000%

Our Google Play Movies Store API allows you to scrape SERP results from Google Play Movies & TV Store. The API is accessed through the following endpoint: /search?engine=google_play_movies. A user may query the following: https://serpapi.com/search?engine=google_play_movies utilizing a GET request. Head to the playground for a live and interactive demo.

Three types of searches you can do are:
- Query Search: by using q parameter
- Category Search: by using movies_category parameter
- Plain Search: without using q or movies_category parameters

API Parameters

Search Query

q

Optional

Parameter defines the query you want to search in Google Play Movies Store.

Localization

gl

Optional

Parameter defines the country to use for the Google Play search. It's a two-letter country code. (e.g., us (default) for the United States, uk for United Kingdom, or fr for France). You can find the full list of Google Play country availability here: Google Play Countries. Afterwards, head to the Google countries page for a two-letter country code.

hl

Optional

Parameter defines the language to use for the Google Play search. It's a two-letter language code. (e.g., en (default) for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.

Google Play Categories

movies_category

Optional

Parameter defines the movies store category. Head to the Google Play store Movies Categories for a full list of supported Google Play Books store categories.

Advanced Google Play Parameters

age

Optional

Parameter defines age subcategory. age works, and should only be used with
movies_category=FAMILY (Family Movies)

It can be set to:
AGE_RANGE1 - Ages up to 5
AGE_RANGE2 - Ages 6-8
AGE_RANGE3 - Ages 9-12

The default value for age is:
- All ages up to 12

Pagination

next_page_token

Optional

Parameter defines the next page token. It is used for retrieving the next page results. It shouldn't be used with the section_page_token, see_more_token, and chart parameters.

section_page_token

Optional

Parameter defines the section page token used for retrieving the pagination results from individual sections. This parameter is a safer version of see_more_token, and is found in every row you can paginate into. It shouldn't be used with the next_page_token, see_more_token, and chart parameters

chart

Optional

Parameter is used for showing top charts. It can return up to 50 results. Each store contains different charts which require different values for retrieving results. To get the value of a specific chart you can use our Google Play Movies Store API JSON output: chart_options[index].value (e.g. chart=topselling_free). It shouldn't be used with the section_page_token, see_more_token, and next_page_token parameters

see_more_token

Optional

Parameter defines the see more token used for retrieving the pagination results from individual sections It is usually found in next page results. It shouldn't be used with the section_page_token, next_page_token, and chart, parameters

Serpapi Parameters

engine

Required

Set parameter to google_play_movies to use the Google Play Movies API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Google Play Movies results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

API Results

JSON Results

JSON output includes structured data for Movies Store Organic Results, Chart Options, and Top Charts results.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

Four types of result structures you can encounter are:
- Rows Results type Organic Results
- List Results type Organic Results
- Top Charts Results
- Chart Options Results

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi. HTML output gives you the raw HTML results from Google.
This API does not have html response when using pagination, retrieving top charts, or retrieveing some movies_category results. It is just a text. search_metadata.prettify_html_file contains prettified version of the result. It is displayed in the playground.

API Examples

JSON structure overview for Rows Type Organic Results and Chart Options

{
  ...
  "chart_options": [
    {
      "text": "String - Chart Option text (Ex: 'Deals')",
      "value": "String - Chart Option value (Ex: 'top_deals')"
    }
  ],
  "organic_results": [
    {
      "title": "String - Organic Result Row title (Ex: 'New York Times® bestsellers')",
      "subtitle": "String - Organic Result Row subtitle (Ex: 'Most popular on Google TV')",
      "serpapi_section_pagination": {
        "next": "String - SerpApi link for paginating into individual row sections",
        "section_page_token": "String - Section Page Token for paginating into individual row sections"
      },
      "see_more_link": "String - Google Play link for paginating into individual row sections. This pagination is not always available.",
      "see_more_token": "String - See More Token for paginating into individual row sections. This pagination is not always available.",
      "serpapi_link": "String - SerpApi link for paginating into individual row sections. This pagination is not always available.",
      "items": [
        {
          "title": "String - Organic Result title (Ex: 'The Whale')",
          "link": "String - Organic Result link (Ex: 'https://play.google.com/store/movies/details/The_Whale?id=Hw9JNjyNk9U.P')",
          "product_id": "String - Organic Result product id (Ex: 'Hw9JNjyNk9U.P)",
          "serpapi_link": "String - SerpApi Google Play Product API link with the product id.",
          "rating": "Float - Organic Result rating (Ex: 4.5)",
          "maturity_rating": "String - Organic Resultmaturity rating  (Ex: 'R')",
          "category": "String - Organic Result category (Ex: 'Drama')",
          "old_price": "String - Organic Result old price (Ex: '$16.99')",
          "extracted_old_price": "Float - Organic Result extracted old price (Ex: 16.99)",
          "price": "String - Organic Result price (Ex: '$14.99')",
          "extracted_price": "Float - Organic Result extracted price (Ex: 14.99)",
          "video": "String - Organic Result video (Ex: 'https://play.google.com/video/lava/web/player/yt:movie:Cf8b2KdLWVM.P?autoplay=1&embed=play')",
          "thumbnail": "String - Organic Result thumbnail",
          "description": "String - Organic Result description",
        },
        ...
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "String - SerpApi link for paginating to next page of rows results",
    "next_page_token": "String - Next Page Token for paginating to next page of rows results"
  },
  ...
}

JSON structure overview for List Type Organic Results

{
  ...
  "organic_results": [
    {
      "title": "String - Organic Result Row title (Ex: 'New York Times® bestsellers')",
      "items": [
        {
          "title": "String - Organic Result title (Ex: 'The Whale')",
          "link": "String - Organic Result link (Ex: 'https://play.google.com/store/movies/details/The_Whale?id=Hw9JNjyNk9U.P')",
          "product_id": "String - Organic Result product id (Ex: 'Hw9JNjyNk9U.P)",
          "serpapi_link": "String - SerpApi Google Play Product API link with the product id.",
          "rating": "Float - Organic Result rating (Ex: 4.5)",
          "maturity_rating": "String - Organic Resultmaturity rating  (Ex: 'R')",
          "category": "String - Organic Result category (Ex: 'Drama')",
          "old_price": "String - Organic Result old price (Ex: '$16.99')",
          "extracted_old_price": "Float - Organic Result extracted old price (Ex: 16.99)",
          "price": "String - Organic Result price (Ex: '$14.99')",
          "extracted_price": "Float - Organic Result extracted price (Ex: 14.99)",
          "video": "String - Organic Result video (Ex: 'https://play.google.com/video/lava/web/player/yt:movie:Cf8b2KdLWVM.P?autoplay=1&embed=play')",
          "thumbnail": "String - Organic Result thumbnail",
          "description": "String - Organic Result description",
        },
        ...
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "String - SerpApi link for paginating to next page of list results",
    "next_page_token": "String - Next Page Token for paginating to next page of list results"
  },
  ...
}

JSON structure overview for Top Charts Results

{
  ...
  "top_charts": [
    {
      "title": "String - Organic Result title (Ex: 'The Whale')",
      "link": "String - Organic Result link (Ex: 'https://play.google.com/store/movies/details/The_Whale?id=Hw9JNjyNk9U.P')",
      "product_id": "String - Organic Result product id (Ex: 'Hw9JNjyNk9U.P)",
      "serpapi_link": "String - SerpApi Google Play Product API link with the product id.",
      "rating": "Float - Organic Result rating (Ex: 4.5)",
      "maturity_rating": "String - Organic Resultmaturity rating  (Ex: 'R')",
      "category": "String - Organic Result category (Ex: 'Drama')",
      "old_price": "String - Organic Result old price (Ex: '$16.99')",
      "extracted_old_price": "Float - Organic Result extracted old price (Ex: 16.99)",
      "price": "String - Organic Result price (Ex: '$14.99')",
      "extracted_price": "Float - Organic Result extracted price (Ex: 14.99)",
      "video": "String - Organic Result video (Ex: 'https://play.google.com/video/lava/web/player/yt:movie:Cf8b2KdLWVM.P?autoplay=1&embed=play')",
      "thumbnail": "String - Organic Result thumbnail",
      "description": "String - Organic Result description",
    },
    ...
  ],
  ...
}

API Examples

List Type Organic results overview for Google Play Movies with section_page_token(Plain Search)

List Type Organic results overview for Google Play Movies with section_page_token(Plain Search)

JSON Example

{
  "search_metadata": {
    "id": "64bfdd7d914a8155cf572670",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/4ef22c42126f884c/64bfdd7d914a8155cf572670.json",
    "created_at": "2023-07-25 14:34:37 UTC",
    "processed_at": "2023-07-25 14:34:37 UTC",
    "google_play_movies_url": "https://play.google.com/store/movies?hl=en&gl=us",
    "raw_html_file": "https://serpapi.com/searches/4ef22c42126f884c/64bfdd7d914a8155cf572670.html",
    "prettify_html_file": "https://serpapi.com/searches/4ef22c42126f884c/64bfdd7d914a8155cf572670.prettify",
    "total_time_taken": 0.77
  },
  "search_parameters": {
    "engine": "google_play_movies",
    "hl": "en",
    "gl": "us",
    "section_page_token": "Cgj6noGdAwIIFBAUGibqAiMiIQobcHJvbW90aW9uX21vdmllc190b3BzZWxsaW5nED8YBA"
  },
  "organic_results": [
    {
      "title": "Top selling",
      "items": [
        {
          "title": "The Machine",
          "link": "https://play.google.com/store/movies/details/The_Machine?id=d_UuiPnQ7yQ.P",
          "product_id": "d_UuiPnQ7yQ.P",
          "serpapi_link": "https://serpapi.com/search.json?engine=google_play_product&gl=us&hl=en&platform=phone&product_id=d_UuiPnQ7yQ.P&sort_by=1",
          "description": "Bert Kreischer rose to fame as a stand-up comedian known as The Machine, and in his signature set he recounts his true experience with Russian mobsters while on a booze-soaked college trip. Now, 23 years later, that trip has come back to haunt him as he and his estranged father (Mark Hamill) are kidnapped back to Russia by the mob to atone for something they say he did. Together, Bert and his father must retrace the steps of his younger self (Jimmy Tatro) in the midst of a war within a sociopathic crime family, all while attempting to find common ground in their often fraught relationship.",
          "rating": 4.0,
          "category": "Action & adventure",
          "original_price": "$24.99",
          "extracted_original_price": 24.99,
          "price": "$14.99",
          "extracted_price": 14.99,
          "thumbnail": "https://play-lh.googleusercontent.com/QXLZ03X-p_CQzEHGJaxghg9vl14jYYMcUYPb3TDwI6assRr4NWuU9adIycrXgoGEhTkw00h9_Ntn8fJZz38"
        },
        {
          "title": "Everything Everywhere All At Once",
          "link": "https://play.google.com/store/movies/details/Everything_Everywhere_All_At_Once?id=W0kO0gqFbBM.P",
          "product_id": "W0kO0gqFbBM.P",
          "serpapi_link": "https://serpapi.com/search.json?engine=google_play_product&gl=us&hl=en&platform=phone&product_id=W0kO0gqFbBM.P&sort_by=1",
          "description": "When an interdimensional rupture threatens to unravel reality, the fate of the world is suddenly in the hands of a most unlikely hero: Evelyn (Michelle Yeoh), an overwhelmed immigrant mother. As bizarre and bewildering dangers emerge from the many possible universes, she must learn to channel her newfound powers and fight to save her home, her family, and herself, in this big-hearted and hilarious adventure through the multiverse.",
          "rating": 4.5,
          "category": "Sci-fi & fantasy",
          "video": "https://play.google.com/video/lava/web/player/yt:movie:3m4TZbb0z9E.P?autoplay=1&embed=play",
          "price": "$3.99",
          "extracted_price": 3.99,
          "thumbnail": "https://play-lh.googleusercontent.com/TcSZz0mjvaAVqQDZXACMCb_JUNXPvDVhrh-THmwNJg-6Li6itvRgG-a-2zeclGf11mqS2bWSlALZMIoT_QdN"
        },
        {
          "title": "Evil Dead Rise",
          "link": "https://play.google.com/store/movies/details/Evil_Dead_Rise?id=4uCec2LSAyI.P",
          "product_id": "4uCec2LSAyI.P",
          "serpapi_link": "https://serpapi.com/search.json?engine=google_play_product&gl=us&hl=en&platform=phone&product_id=4uCec2LSAyI.P&sort_by=1",
          "description": "Moving the action out of the woods and into the city, “Evil Dead Rise” tells a twisted tale of two estranged sisters, played by Sutherland and Sullivan, whose reunion is cut short by the rise of flesh‐possessing demons, thrusting them into a primal battle for survival as they face the most nightmarish version of family imaginable.",
          "rating": 4.1,
          "category": "Horror",
          "video": "https://play.google.com/video/lava/web/player/yt:movie:y4RqiQBnH7w.P?autoplay=1&embed=play",
          "price": "$5.99",
          "extracted_price": 5.99,
          "thumbnail": "https://play-lh.googleusercontent.com/Sa_HsTrsJZbCypRRBv-iiLb4QsR-h4B8q0W77lKeJeZcCq6QQ7PK2xubQ7qZExf9vOFZ1x9_EXk_ERDXEg"
        },
        ...
      ],
    ],
    "serpapi_pagination": {
      "next": "https://serpapi.com/search.json?engine=google_play_movies&gl=us&hl=en&next_page_token=SECT_Cgj6noGdAwIIRhBGGibqAiMiIQobcHJvbW90aW9uX21vdmllc190b3BzZWxsaW5nED8YBA&section_page_token=Cgj6noGdAwIIFBAUGibqAiMiIQobcHJvbW90aW9uX21vdmllc190b3BzZWxsaW5nED8YBA",
      "next_page_token": "SECT_Cgj6noGdAwIIRhBGGibqAiMiIQobcHJvbW90aW9uX21vdmllc190b3BzZWxsaW5nED8YBA"
    }
  }
}

Rows Type Organic results overview for Google Play Movies with next_page_token(Plain Search)

Rows Type Organic results overview for Google Play Movies with next_page_token(Plain Search)

JSON Example

{
  "search_metadata": {
    "id": "641db97b914a81279e45b713",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/4ef22c42126f884c/641db97b914a81279e45b713.json",
    "created_at": "2023-03-24 14:53:47 UTC",
    "processed_at": "2023-03-24 14:53:47 UTC",
    "google_play_movies_url": "https://play.google.com/store/movies?hl=en&gl=us",
    "raw_html_file": "https://serpapi.com/searches/4ef22c42126f884c/641db97b914a81279e45b713.html",
    "prettify_html_file": "https://serpapi.com/searches/4ef22c42126f884c/641db97b914a81279e45b713.prettify",
    "total_time_taken": 0.64
  },
  "search_parameters": {
    "engine": "google_play_movies",
    "hl": "en",
    "gl": "us",
    "next_page_token": "Ciaq5rbCAyAIBRDUzOrbBBCN6LftCxCitbicBBDx2J2cBhCJ5tKdBxAF"
  },
  "organic_results": [
    {
      "title": "New to Rent",
      "serpapi_section_pagination": {
        "next": "https://serpapi.com/search.json?engine=google_play_movies&gl=us&hl=en&section_page_token=Cgj6noGdAwIIChAKGifqAiQiIgoccHJvbW90aW9uX21vdmllc19uZXdfdG9fcmVudBA_GAQ",
        "section_page_token": "Cgj6noGdAwIIChAKGifqAiQiIgoccHJvbW90aW9uX21vdmllc19uZXdfdG9fcmVudBA_GAQ"
      },
      "see_more_link": "https://play.google.com/store/movies/collection/cluster?&gsr=CifqAiQiIgoccHJvbW90aW9uX21vdmllc19uZXdfdG9fcmVudBA_GAQ%3D:S:ANO1ljL5ha8",
      "see_more_token": "CifqAiQiIgoccHJvbW90aW9uX21vdmllc19uZXdfdG9fcmVudBA_GAQ%3D:S:ANO1ljL5ha8",
      "serpapi_link": "https://serpapi.com/search.json?engine=google_play_movies&gl=us&hl=en&see_more_token=CifqAiQiIgoccHJvbW90aW9uX21vdmllc19uZXdfdG9fcmVudBA_GAQ%253D%3AS%3AANO1ljL5ha8",
      "items": [
        {
          "title": "Man Called Otto, A",
          "link": "https://play.google.com/store/movies/details/Man_Called_Otto_A?id=2Mu1xkT0004.P",
          "product_id": "2Mu1xkT0004.P",
          "serpapi_link": "https://serpapi.com/search.json?engine=google_play_product&gl=us&hl=en&product_id=2Mu1xkT0004.P",
          "description": "Based on the # 1 New York Times bestseller “A Man Called Ove,” A Man Called Otto tells the story of Otto Anderson (Tom Hanks), a grump who no longer sees purpose in his life following the loss of his wife. Otto is ready to end it all, but his plans are interrupted when a lively young family moves in next door, and he meets his match in quick-witted Marisol. She challenges him to see life differently, leading to an unlikely friendship that turns his world around. A heartwarming and funny story about love, loss, and life, A Man Called Otto shows that family can sometimes be found in the most unexpected places.",
          "rating": 4.7,
          "category": "Drama",
          "maturity_rating": "PG-13",
          "video": "https://play.google.com/video/lava/web/player/yt:movie:QEaJ7PmyCio.P?autoplay=1&embed=play",
          "price": "$5.99",
          "extracted_price": 5.99,
          "thumbnail": "https://play-lh.googleusercontent.com/ewBmxg_VmoEQCEOpO9jCe9-HnwGLrRO4mL-r1xyJihvh0Us8rmdd9InELj8e9xFKbMP-EZjbyq5pSlv0qqQ"
        },
        {
          "title": "Cocaine Bear",
          "link": "https://play.google.com/store/movies/details/Cocaine_Bear?id=zmwGgJjAlLs.P",
          "product_id": "zmwGgJjAlLs.P",
          "serpapi_link": "https://serpapi.com/search.json?engine=google_play_product&gl=us&hl=en&product_id=zmwGgJjAlLs.P",
          "description": "Inspired by the 1985 true story of a drug runner's plane crash, missing cocaine, and the black bear that ate it, this wild dark comedy finds an oddball group of cops, criminals, tourists and teens converging in a Georgia forest where a 500- pound apex predator has ingested a staggering amount of cocaine and gone on a coke-fueled rampage for more blow ... and blood. Cocaine Bear stars Keri Russell (The Americans), O'Shea Jackson, Jr. (Straight Outta Compton), Christian Convery-Jennings (Sweet Tooth), Alden Ehrenreich (Solo: A Star Wars Story), Jesse Tyler Ferguson (Modern Family), Brooklynn Prince (The Florida Project), Isiah Whitlock Jr. (BlacKkKlansman), Kristofer Hivju (Game of Thrones), Hannah Hoekstra (2019's Charlie's Angels) and Aaron Holliday (Sharp Objects), with Emmy winner Margo Martindale (The Americans) and Emmy winner Ray Liotta (The Many Saints of Newark). Directed by Elizabeth Banks (Charlie's Angels, Pitch Perfect 2) from a screenplay by Jimmy Warden (The Babysitter: Killer Queen), Cocaine Bear is produced by Oscar® winners Phil Lord and Christopher Miller (Spider-Man: Into The Spider-Verse, The Mitchells vs. The Machines) for Lord Miller, Elizabeth Banks (Pitch Perfect franchise) and Max Handelman (Pitch Perfect franchise) for Brownstone Productions, Brian Duffield (Spontaneous) for Jurassic Party Productions and Aditya Sood (The Martian) for Lord Miller. The film is executive produced by Robin Mulcahy Fisichella, Alison Small and Nikki Baida.",
          "rating": 4.3,
          "category": "Action & adventure",
          "maturity_rating": "R",
          "price": "$19.99",
          "extracted_price": 19.99,
          "thumbnail": "https://play-lh.googleusercontent.com/dfItVOG8g_BPDGjd5Uk2DtDZqeN_dPEBmIy7Ec4DH4bL7M6DitrGb3CN_FX6_b5ysejs5_ek_3vgAgApRPQ"
        },
        {
          "title": "Maybe I Do",
          "link": "https://play.google.com/store/movies/details/Maybe_I_Do?id=_wKyTroKwk0.P",
          "product_id": "_wKyTroKwk0.P",
          "serpapi_link": "https://serpapi.com/search.json?engine=google_play_product&gl=us&hl=en&product_id=_wKyTroKwk0.P",
          "description": "In New York City's splendor, Michelle and Allen's romance is at the point where it is time for the parents to finally meet. But now face-to-face, the dinner quickly spirals out of control as the parents realize each spouse is sleeping with the other. Trying to hide the affairs from the kids, their antics turn the night into comedic chaos.",
          "rating": 5,
          "category": "Comedy",
          "maturity_rating": "PG-13",
          "video": "https://play.google.com/video/lava/web/player/yt:movie:9-1aIxf5tic.P?autoplay=1&embed=play",
          "price": "$3.99",
          "extracted_price": 3.99,
          "thumbnail": "https://play-lh.googleusercontent.com/7ihUgxE_9e8oyuvVUgYQrSz-saQ5A5_rX-VQiarqbI2CJuac_jrw3l5s-AcVRP2L5BDWVn8hqEv4FIcMTg"
        },
        ...
      ],
    ],
    "serpapi_pagination": {
      "next": "https://serpapi.com/search.json?engine=google_play_movies&gl=us&hl=en&next_page_token=Ciaq5rbCAyAIDxDNqLbLDxDXgPi0BBDBwPOwCxCWp57sCxChw87WDxAO",
      "next_page_token": "Ciaq5rbCAyAIDxDNqLbLDxDXgPi0BBDBwPOwCxCWp57sCxChw87WDxAO"
    }
  }
}