Google Play

Google Play app details (name, developer, category, rating, installs, descriptions, icon, content rating, price), and an app's reviews newest first.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

Site: googleplay
Version: 1.0.0
Reads from: play.google.com

Action	Description	Listed price
`app`	Read Google Play's details page for each app: its name, developer, category, average rating and rating count, download count, short and full descriptions, icon, cover image, content rating and price. A detail the page's embedded state does not carry comes out null rather than empty: the state is positional, and the store rearranges it without notice.	Billed per request at your plan's rates
`reviews`	Read an app's reviews on Google Play, newest first: each with its id, reviewer name, star score, written time, text, helpful count, developer reply where there is one, and the app build the reviewer wrote from, as the page shows them.	Billed per request at your plan's rates

`app`

Read Google Play's details page for each app: its name, developer, category, average rating and rating count, download count, short and full descriptions, icon, cover image, content rating and price. A detail the page's embedded state does not carry comes out null rather than empty: the state is positional, and the store rearranges it without notice.

POST https://request.usestring.ai/v1/integrations/googleplay/app

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Google Play apps: package ids, such as com.spotify.music, or store details URLs. 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`appId`	string	The app's package id, such as com.spotify.music.
`url`	string	The app's store details page.
`name`	string \| null	The app's display title.
`developerName`	string \| null	—
`developerURL`	string \| null	The developer's page on Google Play.
`genre`	string \| null	The app's store category, as the page names it, such as Music & Audio.
`categoryId`	string \| null	The category's machine id, such as MUSIC_AND_AUDIO.
`ratingAverage`	number \| null	The average star rating, over all the app's ratings.
`ratingCount`	integer \| null	The number of ratings, every star level together.
`ratingCounts`	object	Ratings per star, star as the key: {"1": n, …, "5": n}. May be absent.
`installs`	string \| null	The download count as the page states it, such as 1,000,000,000+.
`contentRating`	string \| null	The page's age rating, such as Teen or Everyone 10+.
`shortDescription`	string \| null	—
`description`	string \| null	The app's full description, paragraph breaks as newlines.
`iconURL`	string \| null	—
`coverImageURL`	string \| null	The tall cover graphic the details page shows, usually 500x1024.
`price`	string \| null	The app's formatted price on the US store, such as $6.99; null for a free app.

Example

curl https://request.usestring.ai/v1/integrations/googleplay/app \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["com.spotify.music"]
  }'

data starts with these rows:

[
  {
    "appId": "com.spotify.music",
    "url": "https://play.google.com/store/apps/details?gl=US&hl=en&id=com.spotify.music",
    "name": "Spotify: Music and Podcasts",
    "developerName": "Spotify AB",
    "developerURL": "https://play.google.com/store/apps/developer?id=Spotify+AB",
    "genre": null,
    "categoryId": "MUSIC_AND_AUDIO",
    "ratingAverage": 4.349193,
    "ratingCount": 36550310,
    "ratingCounts": {
      "1": 3716486,
      "2": 1066485,
      "3": 1308723,
      "4": 3104332,
      "5": 27354269
    },
    "installs": "1,000,000,000+",
    "contentRating": "Teen",
    "shortDescription": null,
    "description": "With the Spotify music and podcast app, you can play millions of songs, albums and original podcasts for free. We have even added audiobooks, so you can enjoy thousands of stories wherever you are!\n\nS…",
    "iconURL": "https://play-lh.googleusercontent.com/mw_NfsvKM8m6RPv8Fz2GQawCOsqWv010saMnc7zbWalMxuaA9IY8h7E0VMieLxSxAFB98NFeYqbFrXXq",
    "coverImageURL": null,
    "price": null
  }
]

Requests and billing

Requests: 1 Web Access request per entry in items.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`reviews`

Read an app's reviews on Google Play, newest first: each with its id, reviewer name, star score, written time, text, helpful count, developer reply where there is one, and the app build the reviewer wrote from, as the page shows them.

POST https://request.usestring.ai/v1/integrations/googleplay/reviews