Logo SearchApi

Google Play Store API

Google Play Store API uses /api/v1/search?engine=google_play_store API endpoint to scrape real-time results

API Parameters

Categories

  • Name
    store
    Required
    Required
    Description

    Parameter defines the store you would like to retrieve. There are several options to pick: apps, games, movies, and books.

  • Name
    category
    Required
    Optional
    Description

    Parameter defines a category to narrow your search. Here are all available Google Play Store apps, movies, and books categories. games categories are included in the apps categories list and should be used with the apps store.

  • Name
    chart
    Required
    Optional
    Description

    Parameter defines the chart that is used to retrieve the top charts and up to 500 results. Chart parameters could be found in store parsers. For instance:
    topselling_free will retrieve the top free apps;
    topselling_paid will retrieve the top paid apps.

Search Query

  • Name
    q
    Required
    Optional
    Description

    Parameter defines the query you want to search. You can use any advanced search operators that you would use in a regular Google Play Store search (e.g. pub:"SEGA").

Localization

  • Name
    gl
    Required
    Optional
    Description

    The default parameter US defines the country of the store. Check the full list of supported Google gl countries.

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the language of the store. Check the full list of supported Google hl languages.

Filters

  • Name
    store_device
    Required
    Optional
    Description

    Default parameter phone - defines the store device of the apps or games store. There is a list of available store devices:
    windows, phone, tablet, tv, chromebook, watch and car.

  • Name
    price
    Required
    Optional
    Description

    Parameter defines the price filter that is used only together with q search parameter with apps and books stores. There are 2 options for a price filter:
    1 will only display free items from given search query;
    2 will only display paid items from given search query.

  • Name
    age
    Required
    Optional
    Description

    The parameter is utilized to filter content based on the age of the target audience. It offers three distinct options:

    • age_range1 option targets content suitable for an audience up to 5 years old.
    • age_range2 option targets content suitable for an audience aged between 6 and 8 years old.
    • age_range3 option targets content suitable for an audience aged between 9 and 12 years old.
    Note that this parameter only takes effect when combined with store and specific category pairs. These are:
    • store=apps and category=FAMILY.
    • store=movies and category=FAMILY.
    • store=books and category=coll_1689.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    Parameter defines the next page token that is used to retrieve the next page of results.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. Current engine - google_play_store.

API Key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Games Store - Landing page

Games Store - Landing page
GET
https://www.searchapi.io/api/v1/search?engine=google_play_store&store=games
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_play_store",
  "store": "games"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "top_charts": [
    {
      "title": "Top free",
      "id": "topselling_free"
    },
    {
      "title": "Top grossing",
      "id": "topgrossing"
    },
    {
      "title": "Top paid",
      "id": "topselling_paid"
    }
  ],
  "organic_results": [
    {
      "title": "Recommended for you",
      "items": [
        {
          "title": "Subway Surfers",
          "link": "https://play.google.com/store/apps/details?id=com.kiloo.subwaysurf",
          "product_id": "com.kiloo.subwaysurf",
          "video": "https://www.youtube.com/embed/Zq74BVEoXSY?ps=play&vq=large&rel=0&autohide=1&showinfo=0",
          "category": "Arcade",
          "rating": 4.6,
          "thumbnail": "https://play-lh.googleusercontent.com/IHpPJDyaTx3wZ6Bqk5RRI3d1SxDlq_hiR8UQ7A7XpZ3t7d4qehI0OTUkqp8wy3b6SQ=s64"
        },
        ...
      ]
    },
    {
      "title": "Stylized games",
      "items": [...]
    },
    ...
  ],
  "highlights": [
    {
      "product": {
        "title": "LotR: Heroes of Middle-earth™",
        "author": "ELECTRONIC ARTS",
        "cta": "Install",
        "cta_snippet": "In-app purchases"
      },
      "id": "com.ea.gp.capitalphx",
      "feature": "Now available",
      "title": "Rally your troops for the journey ahead",
      "subtitle": "Released 2 days ago",
      "link": "https://play.google.com/store/apps/details?id=com.ea.gp.capitalphx",
      "thumbnail": "https://play-lh.googleusercontent.com/1iZy-jkmU9Utcfe__80Vf0zjrFYvia0dB-roH2xa8ziPbfLavc7b7Fe6sRedUL2JdZah6TA9XOEK=w648-h364"
    },
    ...
  ],
  "pagination": {
    "next_page_token": "EAgawgEICBDv0-rpBxDgyJavDxD86Kn2BxDg-tChARDL873zAhDuqqitDBCDgr_OBxCI1q33AhiysZOCCRiPodPrBRjN_pzZDxiqyPqLDRjp8PTABRiwzo5dGOOIt88MGPC094MNGK_XhcYKGK3EwbkLGMW8_tcLGIjPk5wDGOXX6fMJGKr6mp0BGIDfxOcLGPv36PsGGPiL7IQDGPP8xNAGGJ6QqlkYypu_sQoqGHZNa0JYQ2RWNVE5WkZzUWIzSzNPNnc9PQ"
  }
}

Apps Store - Action games category

Apps Store - Action games category
GET
https://www.searchapi.io/api/v1/search?category=GAME_ACTION&engine=google_play_store&store=apps
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_play_store",
  "store": "apps",
  "category": "GAME_ACTION"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "top_charts": [
    {
      "title": "Top free",
      "id": "topselling_free"
    },
    ...
  ],
  "organic_results": [
    {
      "title": "New & updated games",
      "items": [
        {
          "title": "World War Heroes — WW2 PvP FPS",
          "product_id": "com.gamedevltd.wwh",
          "link": "https://play.google.com/store/apps/details?id=com.gamedevltd.wwh",
          "rating": 4.5,
          "thumbnail": "https://play-lh.googleusercontent.com/hK5_ZNBujg7orY0Hqlg4J7x2MeV7sI8wWStlwhiM2Afio7dQuFJfouFmhoFxb62ebqyS=s256"
        },
        ...
      ]
    },
    {
      "title": "Discover recommended games",
      "items": [
        {
          "title": "Talking Tom Gold Run",
          "product_id": "com.outfit7.talkingtomgoldrun",
          "link": "https://play.google.com/store/apps/details?id=com.outfit7.talkingtomgoldrun",
          "category": "Action",
          "rating": 4.3,
          "video": "https://www.youtube.com/embed/7ZTo9Gpwzws?ps=play&vq=large&rel=0&autohide=1&showinfo=0",
          "thumbnail": "https://play-lh.googleusercontent.com/gXHJLOPxbvDkx6pD8VYxwDpqiOsfQKq-kJOCdRiaBdmX0CaAARy_WV4fJjQKT7KG0uI=s64"
        }
      ]
    }
  ],
  "pagination": {
    "next_page_token": "EAgaxAEICBDgyJavDxD07aLjBRDuqqitDBDL873zAhC6l9GNDRD86Kn2BxCHh8WaBhDI1YKTBxjHz7jdCBi33s2bDBjTm4S8Axj79-j7Bhj14OjCBhiP_eqXCRiPvZ_WDhiYhvm7Dxiule3JARik48n5DhjwtPeDDRixgLi7BBjAtYDfBRiF7bjjDRjTqsG8Ahjxhv7cCRivucjsCBiP0b7YDBjM3pTyBhiQoczUBCoYcDBOcmFzSjM0K0JMek95VWE2N21zZz09"
  }
}

Top Charts - Best selling paid apps in US

Top Charts - Best selling paid apps in US
GET
https://www.searchapi.io/api/v1/search?chart=topselling_paid&engine=google_play_store&store=apps
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_play_store",
  "store": "apps",
  "chart": "topselling_paid"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "top_charts": [
    {
      "title": "HotSchedules",
      "product_id": "com.tdr3.hs.android",
      "link": "https://play.google.com/store/apps/details?id=com.tdr3.hs.android",
      "rating": 3.0,
      "author": "HotSchedules",
      "category": "Productivity",
      "description": "​HotSchedules is the industry's leading employee scheduling app because it’s the fastest and easiest way to manage your schedule and communicate with your team. Team members love it because they can swap, pick-up or release shifts with one click. Work-life balance is easily managed with automatic shift pick ups when you want more hours and time off requests for when you don’t. Calendar sync and notifications keep your Schedules and the roster automatically updated to your phone with any manager-approved changes.Managers appreciate the 75% time savings when building schedules and one-click approvals for shift changes. The ability to monitor business performance with sales and labor snapshots from anywhere, keeps them out of the back office. And most importantly, staying connected with broadcast and one-to-one messaging makes for a happy and productive team culture. NOTE: The HotSchedules application REQUIRES a valid HotSchedules user account through your employer. Need help? Contact Customer Care 24x7x365",
      "price": "$2.99",
      "extracted_price": 2.99,
      "currency": "USD",
      "thumbnail": "https://play-lh.googleusercontent.com/cudBRDzsvi50wundWmjnvvaotvejOERDJP4XDur6VtmeiI3aBdGEYmqNVc3Knev5BA",
      "images": [
        "https://play-lh.googleusercontent.com/fy5RAtDgfH3r_3PD-0cMeafq1MIF067IEeoVGOqoC1zh36edFxxYQBJtiuV7hGQTCEke",
        ...
      ]
    },
    ...
  ]
}

Games Store - Tablet device

Games Store - Tablet device
GET
https://www.searchapi.io/api/v1/search?engine=google_play_store&store=games&store_device=tablet
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_play_store",
  "store": "games",
  "store_device": "tablet"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "title": "Find your next obsession",
      "subtitle": "Great on your device",
      "items": [
        {
          "title": "Roblox",
          "link": "https://play.google.com/store/apps/details?id=com.roblox.client",
          "product_id": "com.roblox.client",
          "rating": 4.4,
          "thumbnail": "https://play-lh.googleusercontent.com/WNWZaxi9RdJKe2GQM3vqXIAkk69mnIl4Cc8EyZcir2SKlVOxeUv9tZGfNTmNaLC717Ht=s256-rw"
        },
        ...
      ]
    },
    {
      "title": "Be the first to play",
      "subtitle": "Games in open beta",
      "items": [
        ...
        {
          "title": "Dog Hotel Tycoon",
          "link": "https://play.google.com/store/apps/details?id=com.idle.dog.hotel.tycoon",
          "product_id": "com.idle.dog.hotel.tycoon",
          "video": "https://play.google.com/video/lava/web/player/yt:movie:_GzwVKBRvZo?autoplay=1&embed=play",
          "category": "Simulation",
          "thumbnail": "https://play-lh.googleusercontent.com/_8s5d84jbNrdmx9X0ZzcE0urngQE0uRMw2idSJ5dTA5SC78qUyW_rMh017yHaqIcnrGW=s64-rw"
        }
      ]
    }
  ],
  "pagination": {
    "next_page_token": "EAgaTAgIEKmlgtcCEKKI3M0HEJqs0p8HENC7odYGENWXtP4JEK_F2sICEOzrv6QBEOyk8OsIKhg4RGpndzJwYXZNTHBkVWFzNlNMNkdRPT0"
  }
}

Movies Store - Family movies for kids under the age of 5

Movies Store - Family movies for kids under the age of 5
GET
https://www.searchapi.io/api/v1/search?age=age_range1&category=FAMILY&engine=google_play_store&store=movies
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_play_store",
  "store": "movies",
  "category": "FAMILY",
  "age": "age_range1"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "top_charts": [
    {
      "title": "Top movies",
      "id": "topselling_paid"
    }
  ],
  "organic_results": [
    {
      "title": "Top family movies",
      "subtitle": "Most popular flix",
      "items": [
        {
          "title": "Thomas & Friends: The Adventure Begins",
          "link": "https://play.google.com/store/movies/details/Thomas_Friends_The_Adventure_Begins?id=ZbNbLO1nJ_w",
          "product_id": "ZbNbLO1nJ_w",
          "video": "https://play.google.com/video/lava/web/player/yt:movie:bPRgcqh5PnI?autoplay=1&embed=play",
          "rating": 4.4,
          "price": "$3.99",
          "extracted_price": 3.99,
          "thumbnail": "https://play-lh.googleusercontent.com/uoO6YPzZryf4fyLdFZ4qHPjx6p3eFbMSglLXtkNnXnrmBxO0sptes50SE_ZKnOBKOMF2Wg=s256-rw"
        },
        ...
      ]
    }
  ],
  "pagination": {
    "next_page_token": "CiWq5rbCAx8ICBDYl-mQAxDb78vvDxC_1qvQDRCKkPUUEObQ2oYBEAY"
  }
}

Movies Store - Search query

Movies Store - Search query
GET
https://www.searchapi.io/api/v1/search?engine=google_play_store&q=Cookie&store=movies
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_play_store",
  "store": "movies",
  "q": "Cookie"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "title": "Movies",
      "items": [
        ...
        {
          "title": "Gingerdead Man vs. Evil Bong",
          "link": "https://play.google.com/store/movies/details/Gingerdead_Man_vs_Evil_Bong?id=JsQnB0jGxho",
          "product_id": "JsQnB0jGxho",
          "video": "https://www.youtube.com/embed/c-1dYD53Nv4?ps=play&vq=large&rel=0&autohide=1&showinfo=0",
          "rating": 3.4,
          "original_price": "$2.99",
          "extracted_original_price": 2.99,
          "price": "$1.99",
          "extracted_price": 1.99,
          "thumbnail": "https://play-lh.googleusercontent.com/obGmUG0tSeqzG2My-w4G4At8xtFXMah5NhAEMKl_tbI2pEbGEjKpQVI3uYyM3baOmmkX=s256"
        },
        ...
      ]
    }
  ]
}

Books Store - Search query for only paid books

Books Store - Search query for only paid books
GET
https://www.searchapi.io/api/v1/search?engine=google_play_store&price=2&q=Cookie&store=books
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_play_store",
  "store": "books",
  "q": "Cookie",
  "price": "2"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "title": "Ebooks",
      "items": [
        {
          "title": "Best Christmas Cookie Recipes: Easy Holiday Cookies 2014",
          "link": "https://play.google.com/store/books/details/Katie_Cotton_Best_Christmas_Cookie_Recipes?id=hbroBAAAQBAJ",
          "product_id": "hbroBAAAQBAJ",
          "rating": 4.0,
          "price": "$4.99",
          "extracted_price": 4.99,
          "thumbnail": "https://books.google.com/books/publisher/content/images/frontcover/hbroBAAAQBAJ?fife=w256-h256"
        },
        ...
      ]
    }
  ],
  "pagination": {
    "next_page_token": "Cgj6noGdAwIIFBAUGhOiARAKBkNvb2tpZRgBKgIIAjBAOhAKCAoGQ29va2llEAAYAiAB"
  }
}