> For the complete documentation index, see [llms.txt](https://docs.pullbay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pullbay.com/api-reference/google-play.md).

# Google Play

Google Play Store: app lookup, search, similar apps, reviews, permissions, data safety.

## Get a Google Play application by App ID

> Returns full details for a single app on the Google Play Store, identified by its package name (e.g. \`com.instagram.android\`).\
> \
> \*\*Cost: 1 credit/request + 1 credit/item\*\*

```json
{"openapi":"3.0.3","info":{"title":"Pullbay API","version":"1.0.0"},"tags":[{"name":"google-play","description":"Google Play Store: app lookup, search, similar apps, reviews, permissions, data safety."}],"servers":[{"url":"https://api.pullbay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GooglePlayApplication":{"type":"object","properties":{"title":{"type":"string"},"appId":{"type":"string"},"url":{"type":"string","format":"uri-reference"},"icon":{"type":"string","format":"uri"},"headerImage":{"type":"string","format":"uri"},"summary":{"type":"string"},"description":{"type":"string"},"descriptionHTML":{"type":"string"},"score":{"type":"number"},"scoreText":{"type":"string"},"ratings":{"type":"integer"},"reviews":{"type":"integer"},"histogram":{"type":"object","additionalProperties":{"type":"integer"},"description":"Rating histogram, keyed by star count (1-5)."},"free":{"type":"boolean"},"price":{"type":"number"},"priceText":{"type":"string"},"currency":{"type":"string"},"offersIAP":{"type":"boolean"},"adSupported":{"type":"boolean"},"installs":{"type":"string"},"minInstalls":{"type":"integer"},"maxInstalls":{"type":"integer"},"androidVersion":{"type":"string"},"androidVersionText":{"type":"string"},"updated":{"type":"integer","description":"Unix timestamp in milliseconds"},"genre":{"type":"string"},"genreId":{"type":"string"},"developer":{"type":"string"},"developerId":{"type":"string"},"developerEmail":{"type":"string"},"developerWebsite":{"type":"string","format":"uri"},"developerInternalID":{"type":"string"},"privacyPolicy":{"type":"string","format":"uri"},"playstoreUrl":{"type":"string","format":"uri"},"screenshots":{"type":"array","items":{"type":"string"}}}},"ErrorEnvelope":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"}}}}}}},"paths":{"/google-play/apps":{"get":{"operationId":"getPlayApp","summary":"Get a Google Play application by App ID","description":"Returns full details for a single app on the Google Play Store, identified by its package name (e.g. `com.instagram.android`).\n\n**Cost: 1 credit/request + 1 credit/item**","tags":["google-play"],"parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._]+$"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z]{2,3}(-[a-z]{2,3})?$"}}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayApplication"}},"pricing":{"type":"object","properties":{"creditsCharged":{"type":"number"}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```

## Search Google Play applications

> Search the Google Play Store for apps matching \`search\`. Returns lightweight summaries.\
> \
> \*\*Cost: 1 credit/request + 1 credit/item\*\*

```json
{"openapi":"3.0.3","info":{"title":"Pullbay API","version":"1.0.0"},"tags":[{"name":"google-play","description":"Google Play Store: app lookup, search, similar apps, reviews, permissions, data safety."}],"servers":[{"url":"https://api.pullbay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GooglePlayApplicationSummary":{"type":"object","description":"Lightweight app reference returned by search and similar endpoints.","properties":{"title":{"type":"string"},"appId":{"type":"string"},"url":{"type":"string","format":"uri-reference"},"icon":{"type":"string","format":"uri"},"summary":{"type":"string"},"score":{"type":"number"},"scoreText":{"type":"string"},"free":{"type":"boolean"},"price":{"type":"number"},"currency":{"type":"string"},"playstoreUrl":{"type":"string","format":"uri"},"developer":{"type":"string"},"developerId":{"type":"string"}}},"ErrorEnvelope":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"}}}}}}},"paths":{"/google-play/search":{"get":{"operationId":"searchPlayApps","summary":"Search Google Play applications","description":"Search the Google Play Store for apps matching `search`. Returns lightweight summaries.\n\n**Cost: 1 credit/request + 1 credit/item**","tags":["google-play"],"parameters":[{"name":"search","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"price","in":"query","required":false,"schema":{"type":"string","enum":["all","free","paid"]}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z]{2,3}(-[a-z]{2,3})?$"}}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayApplicationSummary"}},"pricing":{"type":"object","properties":{"creditsCharged":{"type":"number"}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```

## Get similar Google Play applications

> Returns apps Google Play surfaces as similar to the supplied \`appId\`.\
> \
> \*\*Cost: 1 credit/request + 1 credit/item\*\*

```json
{"openapi":"3.0.3","info":{"title":"Pullbay API","version":"1.0.0"},"tags":[{"name":"google-play","description":"Google Play Store: app lookup, search, similar apps, reviews, permissions, data safety."}],"servers":[{"url":"https://api.pullbay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GooglePlayApplicationSummary":{"type":"object","description":"Lightweight app reference returned by search and similar endpoints.","properties":{"title":{"type":"string"},"appId":{"type":"string"},"url":{"type":"string","format":"uri-reference"},"icon":{"type":"string","format":"uri"},"summary":{"type":"string"},"score":{"type":"number"},"scoreText":{"type":"string"},"free":{"type":"boolean"},"price":{"type":"number"},"currency":{"type":"string"},"playstoreUrl":{"type":"string","format":"uri"},"developer":{"type":"string"},"developerId":{"type":"string"}}},"ErrorEnvelope":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"}}}}}}},"paths":{"/google-play/similar":{"get":{"operationId":"getSimilarPlayApps","summary":"Get similar Google Play applications","description":"Returns apps Google Play surfaces as similar to the supplied `appId`.\n\n**Cost: 1 credit/request + 1 credit/item**","tags":["google-play"],"parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._]+$"}}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayApplicationSummary"}},"pricing":{"type":"object","properties":{"creditsCharged":{"type":"number"}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```

## Get reviews for a Google Play application

> Returns reviews for an app. Use \`cursor\` to paginate or \`maxItems\` for a one-shot bulk pull (mutually exclusive). \`sort\` accepts \`NEWEST\`, \`RATING\`, or \`HELPFULNESS\`.\
> \
> \*\*Cost: 1 credit/request + 1 credit/item\*\*

```json
{"openapi":"3.0.3","info":{"title":"Pullbay API","version":"1.0.0"},"tags":[{"name":"google-play","description":"Google Play Store: app lookup, search, similar apps, reviews, permissions, data safety."}],"servers":[{"url":"https://api.pullbay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GooglePlayReview":{"type":"object","properties":{"id":{"type":"string"},"userName":{"type":"string"},"userImage":{"type":"string","format":"uri"},"date":{"type":"string","format":"date-time"},"score":{"type":"integer","minimum":1,"maximum":5},"scoreText":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string","nullable":true},"text":{"type":"string"},"replyDate":{"type":"string","format":"date-time","nullable":true},"replyText":{"type":"string","nullable":true},"version":{"type":"string"},"thumbsUp":{"type":"integer"},"country":{"type":"string"},"criterias":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayReviewCriteria"}}}},"GooglePlayReviewCriteria":{"type":"object","properties":{"criteria":{"type":"string"},"rating":{"type":"integer"}}},"Pagination":{"type":"object","properties":{"page":{"type":"integer","nullable":true},"hasNextPage":{"type":"boolean","nullable":true},"cursor":{"type":"string","nullable":true},"offset":{"type":"string","nullable":true,"description":"Numeric offset string for offset-paginated endpoints (e.g. Google Maps place search)."}}},"ErrorEnvelope":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"}}}}}}},"paths":{"/google-play/reviews":{"get":{"operationId":"getPlayReviews","summary":"Get reviews for a Google Play application","description":"Returns reviews for an app. Use `cursor` to paginate or `maxItems` for a one-shot bulk pull (mutually exclusive). `sort` accepts `NEWEST`, `RATING`, or `HELPFULNESS`.\n\n**Cost: 1 credit/request + 1 credit/item**","tags":["google-play"],"parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._]+$"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z]{2,3}(-[a-z]{2,3})?$"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["NEWEST","RATING","HELPFULNESS"]}},{"name":"maxItems","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayReview"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"pricing":{"type":"object","properties":{"creditsCharged":{"type":"number"}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```

## Get permissions requested by a Google Play application

> Returns the list of Android permissions the app requests, grouped by category.\
> \
> \*\*Cost: 1 credit/request + 1 credit/item\*\*

```json
{"openapi":"3.0.3","info":{"title":"Pullbay API","version":"1.0.0"},"tags":[{"name":"google-play","description":"Google Play Store: app lookup, search, similar apps, reviews, permissions, data safety."}],"servers":[{"url":"https://api.pullbay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GooglePlayPermission":{"type":"object","properties":{"permission":{"type":"string"},"type":{"type":"string"}}},"ErrorEnvelope":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"}}}}}}},"paths":{"/google-play/permissions":{"get":{"operationId":"getPlayPermissions","summary":"Get permissions requested by a Google Play application","description":"Returns the list of Android permissions the app requests, grouped by category.\n\n**Cost: 1 credit/request + 1 credit/item**","tags":["google-play"],"parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._]+$"}}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayPermission"}},"pricing":{"type":"object","properties":{"creditsCharged":{"type":"number"}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```

## Get the Data Safety section for a Google Play application

> Returns the developer-declared Data Safety information: data shared, data collected, security practices, and privacy policy URL.\
> \
> \*\*Cost: 1 credit/request + 1 credit/item\*\*

```json
{"openapi":"3.0.3","info":{"title":"Pullbay API","version":"1.0.0"},"tags":[{"name":"google-play","description":"Google Play Store: app lookup, search, similar apps, reviews, permissions, data safety."}],"servers":[{"url":"https://api.pullbay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GooglePlayDataSafety":{"type":"object","properties":{"sharedData":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayDataSafetyItem"}},"collectedData":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayDataSafetyItem"}},"securityPractices":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlaySecurityPractice"}},"privacyPolicyUrl":{"type":"string","format":"uri"}}},"GooglePlayDataSafetyItem":{"type":"object","properties":{"data":{"type":"string"},"purpose":{"type":"string"},"type":{"type":"string"},"optional":{"type":"boolean"}}},"GooglePlaySecurityPractice":{"type":"object","properties":{"practice":{"type":"string"},"description":{"type":"string"}}},"ErrorEnvelope":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"}}}}}}},"paths":{"/google-play/data-safety":{"get":{"operationId":"getPlayDataSafety","summary":"Get the Data Safety section for a Google Play application","description":"Returns the developer-declared Data Safety information: data shared, data collected, security practices, and privacy policy URL.\n\n**Cost: 1 credit/request + 1 credit/item**","tags":["google-play"],"parameters":[{"name":"appId","in":"query","required":true,"schema":{"type":"string","maxLength":255,"pattern":"^[A-Za-z0-9._]+$"}}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"status":{"type":"integer"},"message":{"type":"string"},"success":{"type":"boolean"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GooglePlayDataSafety"}},"pricing":{"type":"object","properties":{"creditsCharged":{"type":"number"}}}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```