JustSERPDocs
Google

Google Play Store

Google Play store pages as clusters of apps, answered as the document: a search (`q`), a store's landing page or a category page.

GET
/v1/google/play

Google Play store pages as clusters of apps, answered as the document: a search (q), a store's landing page or a category page. top_charts are the store's chart names (topselling_free, topgrossing, topselling_paid, a fixed list) and organic_results the clusters {title, items}; a search's first hit is the cluster "Top result", tiles outside a cluster have a null title. Only clusters of app tiles are read: the movies and books pages answer an empty organic_results. chart and next_page_token are refused (400): the chart lists and the pages after the first are not read. Not answered: highlights, pagination, per-item video.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
store?string

Which store.

Default"apps"
Value in"apps""games""movies""books"
q?string

A search (the apps and books stores; games searches apps).

category?string

A Play category id (GAME_ACTION, SOCIAL, coll_1689). Games categories go with store=apps.

gl?string

Country of the store.

Match^[A-Za-z]{2}$
Default"us"
hl?string

Language of the store.

Default"en"
store_device?string

windows, phone, tablet, tv, chromebook, watch or car (sent as device=).

Default"phone"
price?string

With q: 1 free, 2 paid.

Value in"1""2"
age?string

age_range1 to age_range3.

Response Body

The clusters, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The first keys of a document-form answer. Unlike DocumentHead there is no search_information unless the engine has one (there is none for the AI engines, Events, Events Details, Facebook, Tripadvisor Place, Trending Now and the Apple engines' places).

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
top_charts?array<>

The store's chart names.

organic_results?array<>
Example Request
curl -X GET 'https://api.justserp.com/v1/google/play?store=apps&q=photo+editor&gl=us&hl=en'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "top_charts": [    {}  ],  "organic_results": [    {      "title": "string",      "items": [        {          "title": "string",          "link": "string",          "product_id": "string",          "author": "string",          "category": "string",          "rating": 0,          "downloads": "string",          "free": true,          "description": "string",          "thumbnail": "string"        }      ]    }  ]}

Google Maps Photos GET

The photos of one Google Maps place, 20 a page, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`{}`), `photos` and `pagination.next_page_token` (absent on the last page; a page past the end has neither).

Google Play Product GET

The Play page of an app (`store=apps`), with its reviews, answered as the document: `product`, `media`, `permissions`, `data_safety`, `additional_information`, `similar_products`, `reviews` and `reviews_pagination.next_page_token`.