A PHP scraper to get app data from Google Play.
Add raulr/google-play-scraper
as a require dependency in your composer.json
file:
$ composer require raulr/google-play-scraper
First create a Scraper
instance.
use Raulr\GooglePlayScraper\Scraper;
$scraper = new Scraper();
There are several methods to configure the default behavior:
setDelay($delay)
: Sets the delay in milliseconds between requests to Google Play site.setDefaultLang($lang)
: Sets the default language for all requests.$lang
must be an ISO_639-1 two letter language code. If not set, the default language isen
.setDefaultCountry($country)
: Sets the default country for all requests.$country
must be an ISO_3166-1 two letter country code. If not set, the default country isus
.
Gets app information given its ID.
$id
: Google Play app identifier.$lang
: (optional, defaults tonull
): Overrides the default language.$country
: (optional, defaults tonull
): Overrides the default country.
$app = $scraper->getApp('com.mojang.minecraftpe');
Returns:
array (
'id' => 'com.mojang.minecraftpe',
'url' => 'https://play.google.com/store/apps/details?id=com.mojang.minecraftpe',
'image' => 'https://lh3.googleusercontent.com/VSwHQjcAttxsLE47RuS4PqpC4LT7lCoSjE7Hx5AW_yCxtDvcnsHHvm5CTuL5BPN-uRTP=s180',
'title' => 'Minecraft',
'author' => 'Mojang',
'author_link' => 'https://play.google.com/store/apps/developer?id=Mojang',
'categories' => array (
'Arcade',
'Action & Adventure',
),
'price' => '$6.99',
'screenshots' => array (
'https://lh3.googleusercontent.com/28b1vxJQe916wOaSVB4CmcnDujk8M2SNaCwqtQ4cUS0wYKYn9kCYeqxX0uyI2X-nQv0=w720-h310',
'https://lh3.googleusercontent.com/VkLE0e0EDuRID6jdTE97cC8BomcDReJtZOem9Jlb14jw9O7ytAGvE-2pLqvoSJ7w3IdK=w720-h310',
// [...]
),
'description' => 'Explore infinite worlds and build everything from the simplest of homes to the grandest of castles[...]',
'description_html' => 'Explore infinite worlds and build everything from the simplest of homes to the grandest of castles[...]',
'rating' => 4.5,
'votes' => 2736136,
'last_updated' => 'May 23, 2019',
'size' => null,
'downloads' => '10,000,000+',
'version' => '1.11.4.2',
'supported_os' => '4.2 and up',
'content_rating' => 'Everyone 10+',
'whatsnew' => 'What\'s new in version 1.11?[...]',
'author_website' => 'http:\/\/help.mojang.com',
'author_email' => 'android-help@mojang.com',
'privacy_policy_link' => 'https:\/\/privacy.microsoft.com\/en-us\/privacystatement'
)
The following fields may contain a null
value: price
, last_updated
, size
, downloads
, version
, supported_os
, content_rating
, whatsnew
, video_link
and video_image
. The price
being null
means the app is free.
Gets information for multiple apps given their IDs.
$ids
: Array of Google Play app identifiers.$lang
: (optional, defaults tonull
): Overrides the default language.$country
: (optional, defaults tonull
): Overrides the default country.
$app = $scraper->getApps(array(
'com.mojang.minecraftpe',
'com.google.android.youtube',
));
Returns an array with the existing categories in Google Play.
use Raulr\GooglePlayScraper\Scraper;
$scraper = new Scraper();
$categories = $scraper->getCategories();
Returns:
array (
'ART_AND_DESIGN',
'AUTO_AND_VEHICLES',
'BEAUTY',
'BOOKS_AND_REFERENCE',
'BUSINESS',
'COMICS',
'COMMUNICATION',
'DATING',
'EDUCATION',
'ENTERTAINMENT',
'EVENTS',
'FINANCE',
'FOOD_AND_DRINK',
'HEALTH_AND_FITNESS',
'HOUSE_AND_HOME',
'LIBRARIES_AND_DEMO',
'LIFESTYLE',
'MAPS_AND_NAVIGATION',
'MEDICAL',
'MUSIC_AND_AUDIO',
'NEWS_AND_MAGAZINES',
'PARENTING',
'PERSONALIZATION',
'PHOTOGRAPHY',
'PRODUCTIVITY',
'SHOPPING',
'SOCIAL',
'SPORTS',
'TOOLS',
'TRAVEL_AND_LOCAL',
'VIDEO_PLAYERS',
'ANDROID_WEAR',
'WEATHER',
'GAME',
'GAME_ACTION',
'GAME_ADVENTURE',
'GAME_ARCADE',
'GAME_BOARD',
'GAME_CARD',
'GAME_CASINO',
'GAME_CASUAL',
'GAME_EDUCATIONAL',
'GAME_MUSIC',
'GAME_PUZZLE',
'GAME_RACING',
'GAME_ROLE_PLAYING',
'GAME_SIMULATION',
'GAME_SPORTS',
'GAME_STRATEGY',
'GAME_TRIVIA',
'GAME_WORD',
'FAMILY',
'FAMILY_ACTION',
'FAMILY_BRAINGAMES',
'FAMILY_CREATE',
'FAMILY_EDUCATION',
'FAMILY_MUSICVIDEO',
'FAMILY_PRETEND'
)
Returns an array with the existing collections in Google Play.
$collections = $scraper->getCollections();
Returns:
array (
'topselling_free',
'topselling_paid',
'topselling_new_free',
'topselling_new_paid',
'topgrossing',
'movers_shakers',
)
Retrieves a list of Google Play apps given a collection and optionally filtered by category.
$collection
: Google Play collection to retrieve. See getCollections for possible values.$category
: (optional, defaults tonull
) Filter request by this category. See getCategories for possible values.$lang
: (optional, defaults tonull
): Overrides the default language.$country
: (optional, defaults tonull
): Overrides the default country.
$apps = $scraper->getList('topselling_free', 'SOCIAL');
Returns:
array (
array (
'id' => 'com.facebook.katana',
'url' => 'https://play.google.com/store/apps/details?id=com.facebook.katana',
'title' => 'Facebook',
'image' => 'https://lh3.googleusercontent.com/ZZPdzvlpK9r_Df9C3M7j1rNRi7hhHRvPhlklJ3lfi5jk86Jd1s0Y5wcQ1QgbVaAP5Q=w340',
'author' => 'Facebook',
'rating' => 3.9888803958892822,
'price' => null,
),
array (
'id' => 'com.snapchat.android',
'url' => 'https://play.google.com/store/apps/details?id=com.snapchat.android',
'title' => 'Snapchat',
'image' => 'https://lh4.ggpht.com/vdK_CsMSsJoYvJpYgaj91fiJ1T8rnSHHbXL0Em378kQaaf_BGyvUek2aU9z2qbxJCAFV=w340',
'author' => 'Snapchat Inc',
'rating' => 3.8660063743591309,
'price' => null,
),
// [...]
)
Same as getList but returning full detail app data. An additional request is made for every app from the list in order to get its details.
Retrieves a chunk of a Google Play app list.
$collection
: Google Play collection to retrieve. See getCollections for possible values.$category
: (optional, defaults tonull
) Filter request by this category. See getCategories for possible values.$start
: (optional, defaults to0
): Starting index. Must be a value between0
and180
.$num
: (optional, defaults to60
): Amount of apps to retrieve. Must be a value between0
and120
.$lang
: (optional, defaults tonull
): Overrides the default language.$country
: (optional, defaults tonull
): Overrides the default country.
$apps = $scraper->getListChunk('topselling_free', 'SOCIAL', 20, 80);
Same as getListChunk but returning full detail app data. An additional request is made for every app from the list in order to get its details.
Retrieves a list of Google Play apps given a search query and optionally filtered by price and rating.
$query
: Search query.$price
: (optional, defaults toall
) Filter request by price. Possible values:all
,free
,paid
.$rating
: (optional, defaults toall
) Filter request by rating. Possible values:all
,4+
.$lang
: (optional, defaults tonull
): Overrides the default language.$country
: (optional, defaults tonull
): Overrides the default country.
$apps = $scraper->getSearch('unicorns', 'free', '4+');
Same as getSearch but returning full detail app data. An additional request is made for every app from the search result in order to get its details.