Skip to content
Examples

Get Results

Retrieve scraped data from Google Play Store Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Google Play Store Scraper runs. Two row types share the same table: record_type = "app" for app listings, record_type = "review" for their reviews. Fields marked "App rows only" or "Review rows only" are left empty on the other type.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY.

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

pageintegerquery

Page number (default: 1).

Result Fields

Common

record_typestring

Type of row: app for an app listing, review for one of its reviews.

record_idstring

Identifier of the row: the package id on an app row, the review id on a review row.

source_urlstring

The task input that produced this row (app URL, package id, search URL or keyword).

package_idstring

Android package id of the app this row belongs to. Example: com.whatsapp

app_urlstring

Google Play URL of the app this row belongs to.

app_titlestring

Title of the app this row belongs to, filled on review rows as well. Example: WhatsApp Messenger

App rows

titlestring

Title of the app. App rows only.

developerstring

Name of the developer publishing the app.

developer_idstring

Google Play developer id, usable as https://play.google.com/store/apps/dev?id=<developer_id>.

developer_urlstring

Developer website declared on the listing.

developer_emailstring

Support email declared by the developer.

developer_addresstext

Postal address declared by the developer.

categorystring

Primary Google Play category of the app. Example: Communication

category_idstring

Google Play identifier of the primary category. Example: COMMUNICATION

pricefloat

Price of the app in the selected storefront, 0 when the app is free.

currencystring

Currency the price is expressed in.

is_freeboolean

True when the app costs nothing to install.

in_app_purchasesstring

Price range of the in-app purchases the app offers, empty when it offers none. Example: $0.99 - $49.99 per item

installsstring

Install count as displayed on the listing. Example: 10,000,000,000+

installs_minbigint

Lower bound of the displayed install count, as a number.

installs_exactbigint

Precise install count Google Play carries in the page payload.

scorefloat

Average rating of the app, empty when the app has no rating yet.

ratings_countbigint

Number of star ratings the app received.

reviews_countbigint

Number of written reviews the app received, always smaller than ratings_count.

rating_histogramjson

Number of ratings per star level, from 1 to 5.

descriptiontext

Full store description of the app, as plain text.

summarytext

Short tagline shown under the app title.

versionstring

Current version of the app. Google Play leaves it empty for apps that publish device-specific builds; the version of the most recent review is used when available.

android_versionstring

Minimum Android version the app requires (8.0, 7.0, 6.0...). Empty for apps that ship device-specific builds.

updated_atdatetime

Date the app was last updated on Google Play (UTC).

released_atdatetime

Date the app was first released on Google Play (UTC).

content_ratingstring

Content rating of the app, e.g. Everyone, Teen, Mature 17+.

content_rating_detailstring

Reason given for the content rating, e.g. Users Interact.

screenshotsjson

Screenshot URLs published on the listing, in display order.

iconstring

App icon URL.

header_imagestring

Feature graphic shown at the top of the listing.

privacy_policy_urlstring

Privacy policy URL declared by the developer.

videostring

Promo video published on the listing, empty when the app has none.

video_imagestring

Thumbnail of the promo video.

ad_supportedboolean

True when Google Play shows the "Contains ads" badge on the listing.

recent_changestext

Changelog of the latest update, as plain text.

rankingstring

Chart position of the app on Google Play when it is ranked. Example: #1 top free communication

Review rows

review_idstring

Google Play identifier of the review.

review_urlstring

Direct link to the review on the app listing.

authorstring

Display name of the reviewer.

author_idstring

Google identifier of the reviewer.

author_imagestring

Profile picture of the reviewer.

ratinginteger

Star rating given by the reviewer, 1 to 5.

texttext

Body of the review.

thumbs_upinteger

Number of users who marked the review as helpful.

review_datedatetime

Date the review was posted (UTC).

app_versionstring

Version of the app the reviewer had installed.

developer_replytext

Reply the developer posted to the review, empty when there is none.

reply_datedatetime

Date the developer replied (UTC).

review_criteriasjson

Sub-ratings the reviewer gave on the app's own criteria, mostly on games. Empty on most reviews.

Code Examples

curl -G https://api.lobstr.io/v1/results \
  -H "Authorization: Token YOUR_API_KEY" \
  -d "squid=YOUR_SQUID_HASH" \
  -d "page=1"

Response

200
{"total_results": 1, "data": [{"record_type": "review", "record_id": "d40bb75a-d1a5-44b3-863d-c8624445efe9", "source_url": "https://play.google.com/store/apps/details?id=com.whatsapp", "package_id": "com.whatsapp", "app_title": "WhatsApp Messenger", "author": "Jonathan Spencer", "rating": 1, "text": "The most useless app I've encountered since the last update.", "thumbs_up": 5, "review_date": "2026-08-28 20:40:15", "app_version": "2.26.33.74"}]}