For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Play

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

Get a Google Play application by App ID

get

Returns full details for a single app on the Google Play Store, identified by its package name (e.g. com.instagram.android).

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
appIdstring · max: 255RequiredExample: com.instagram.androidPattern: ^[A-Za-z0-9._]+$
countrystring · min: 2 · max: 2Optional
langstringOptionalPattern: ^[a-z]{2,3}(-[a-z]{2,3})?$
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-play/apps
GET /google-play/apps?appId=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "title": "Instagram",
      "appId": "com.instagram.android",
      "url": "/api/apps/com.instagram.android",
      "icon": "https://play-lh.googleusercontent.com/VRMWkE5p3CkWhJs6nv-9ZsLAs1QOg5ob1_3qg-rckwYW7yp1fMrYZqnEFpk0IoVP4LM",
      "headerImage": "https://play-lh.googleusercontent.com/CgUPurtUp8SB709wsQcKLMv6JdIh1em0ka_58V69AorznLv42TV39etS2rt28wv9Rz8",
      "summary": "Create &amp; share photos, stories, &amp; reels with friends you love",
      "description": "Little moments lead to big friendships. Share yours on Instagram.",
      "descriptionHTML": "Little moments lead to big friendships. Share yours on Instagram. <br>—From Meta",
      "score": 4.0182447,
      "scoreText": "4.0",
      "ratings": 167461256,
      "reviews": 4568306,
      "histogram": {
        "1": 30279668,
        "2": 5233417,
        "3": 7039797,
        "4": 13507336,
        "5": 111401011
      },
      "free": true,
      "price": 0,
      "priceText": "Free",
      "currency": "USD",
      "offersIAP": true,
      "adSupported": true,
      "installs": "5,000,000,000+",
      "minInstalls": 5000000000,
      "maxInstalls": 7427343782,
      "androidVersion": "VARY",
      "androidVersionText": "Varies with device",
      "updated": 1777328205000,
      "genre": "Social",
      "genreId": "SOCIAL",
      "developer": "Instagram",
      "developerId": "Instagram",
      "developerEmail": "[email protected]",
      "developerWebsite": "http://help.instagram.com/",
      "developerInternalID": "Instagram",
      "privacyPolicy": "http://instagram.com/legal/privacy/",
      "playstoreUrl": "https://play.google.com/store/apps/details?id=com.instagram.android&hl=en&gl=us",
      "screenshots": [
        "https://play-lh.googleusercontent.com/hZ2Ob6d0MqLse2lIdNOGgl93H5y82uhX4hC6mWDUpdwK8LjXAunweDQZ6Hocy0riv4KX0lTIzKJz6lhRDV_BiHg"
      ]
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}
get

Search the Google Play Store for apps matching search. Returns lightweight summaries.

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
searchstring · min: 1 · max: 255RequiredExample: instagram
pricestring · enumOptionalPossible values:
countrystring · min: 2 · max: 2Optional
langstringOptionalPattern: ^[a-z]{2,3}(-[a-z]{2,3})?$
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-play/search
GET /google-play/search?search=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "title": "Instagram",
      "appId": "com.instagram.android",
      "url": "/api/apps/com.instagram.android",
      "icon": "https://play-lh.googleusercontent.com/VRMWkE5p3CkWhJs6nv-9ZsLAs1QOg5ob1_3qg-rckwYW7yp1fMrYZqnEFpk0IoVP4LM",
      "summary": "Create &amp; share photos, stories, &amp; reels with friends you love",
      "score": 4.0182447,
      "scoreText": "4.0",
      "free": true,
      "price": 0,
      "currency": "USD",
      "playstoreUrl": "https://play.google.com/store/apps/details?id=com.instagram.android",
      "developer": "Instagram",
      "developerId": "Instagram"
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}

Get similar Google Play applications

get

Returns apps Google Play surfaces as similar to the supplied appId.

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
appIdstring · max: 255RequiredExample: com.instagram.androidPattern: ^[A-Za-z0-9._]+$
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-play/similar
GET /google-play/similar?appId=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "title": "Instagram",
      "appId": "com.instagram.android",
      "url": "/api/apps/com.instagram.android",
      "icon": "https://play-lh.googleusercontent.com/VRMWkE5p3CkWhJs6nv-9ZsLAs1QOg5ob1_3qg-rckwYW7yp1fMrYZqnEFpk0IoVP4LM",
      "summary": "Create &amp; share photos, stories, &amp; reels with friends you love",
      "score": 4.0182447,
      "scoreText": "4.0",
      "free": true,
      "price": 0,
      "currency": "USD",
      "playstoreUrl": "https://play.google.com/store/apps/details?id=com.instagram.android",
      "developer": "Instagram",
      "developerId": "Instagram"
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}

Get reviews for a Google Play application

get

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.

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
appIdstring · max: 255RequiredExample: com.instagram.androidPattern: ^[A-Za-z0-9._]+$
countrystring · min: 2 · max: 2Optional
langstringOptionalPattern: ^[a-z]{2,3}(-[a-z]{2,3})?$
sortstring · enumOptionalPossible values:
maxItemsinteger · min: 1 · max: 500Optional
cursorstringOptional
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-play/reviews
GET /google-play/reviews?appId=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "045b1b4e-b207-40f7-8a9e-d4e81664965e",
      "userName": "Jane Doe",
      "userImage": "https://example.com/reviewer-photo.jpg",
      "date": "2025-01-12T22:37:55.959Z",
      "score": 1,
      "scoreText": "1",
      "url": "https://play.google.com/store/apps/details?id=com.instagram.android&reviewId=045b1b4e-b207-40f7-8a9e-d4e81664965e",
      "title": null,
      "text": "The new update is so buggy.",
      "replyDate": null,
      "replyText": null,
      "version": "362.0.0.33.241",
      "thumbsUp": 10224,
      "country": "US",
      "criterias": [
        {
          "criteria": "vaf_mark_message_as_read",
          "rating": 1
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}

Get permissions requested by a Google Play application

get

Returns the list of Android permissions the app requests, grouped by category.

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
appIdstring · max: 255RequiredExample: com.instagram.androidPattern: ^[A-Za-z0-9._]+$
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-play/permissions
GET /google-play/permissions?appId=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "permission": "find accounts on the device",
      "type": "Identity"
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}

Get the Data Safety section for a Google Play application

get

Returns the developer-declared Data Safety information: data shared, data collected, security practices, and privacy policy URL.

Price: $0.0002 per item

Minimum charge: $0.002 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
appIdstring · max: 255RequiredExample: com.instagram.androidPattern: ^[A-Za-z0-9._]+$
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-play/data-safety
GET /google-play/data-safety?appId=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "sharedData": [
        {
          "data": "Name",
          "purpose": "Fraud prevention, security, and compliance",
          "type": "Personal info",
          "optional": false
        }
      ],
      "collectedData": [
        {
          "data": "Name",
          "purpose": "Fraud prevention, security, and compliance",
          "type": "Personal info",
          "optional": false
        }
      ],
      "securityPractices": [
        {
          "practice": "Data is encrypted in transit",
          "description": "Your data is transferred over a secure connection"
        }
      ],
      "privacyPolicyUrl": "http://instagram.com/legal/privacy/"
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.002000",
    "billableItems": 10
  }
}

Last updated