Google Play Developer Reviews API

The Reviews API from Google Play Developer — 3 operation(s) for reviews.

GitHub OpenAPI

Operations 3

GET /androidpublisher/v3/applications/{packageName}/reviews List reviews #
GET /androidpublisher/v3/applications/{packageName}/reviews/{reviewId} Get reviews #
POST /androidpublisher/v3/applications/{packageName}/reviews/{reviewId}:reply Reply reviews #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/google-play:google-play-reviews-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-play-reviews-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Google Play Android Developer Reviews API
  version: v3
  description: Generated from Google's published Discovery document for Google Play Android Developer API (androidpublisher v3, revision 20261111). 3 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://androidpublisher.googleapis.com
tags:
- name: Reviews
paths:
  /androidpublisher/v3/applications/{packageName}/reviews:
    get:
      operationId: androidpublisher.reviews.list
      summary: List reviews
      description: Lists all reviews.
      parameters:
      - name: packageName
        in: path
        required: true
        description: Package name of the app.
        schema:
          type: string
      - name: maxResults
        in: query
        required: false
        description: How many results the list operation should return.
        schema:
          format: uint32
          type: integer
      - name: startIndex
        in: query
        required: false
        description: The index of the first element to return.
        schema:
          type: integer
          format: uint32
      - name: token
        in: query
        required: false
        description: Pagination token. If empty, list starts at the first review.
        schema:
          type: string
      - name: translationLanguage
        in: query
        required: false
        description: Language localization code.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReviewsListResponse'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidpublisher
      - apiKey: []
      tags:
      - Reviews
  /androidpublisher/v3/applications/{packageName}/reviews/{reviewId}:
    get:
      operationId: androidpublisher.reviews.get
      summary: Get reviews
      description: Gets a single review.
      parameters:
      - name: packageName
        in: path
        required: true
        description: Package name of the app.
        schema:
          type: string
      - name: reviewId
        in: path
        required: true
        description: Unique identifier for a review.
        schema:
          type: string
      - name: translationLanguage
        in: query
        required: false
        description: Language localization code.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Review'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidpublisher
      - apiKey: []
      tags:
      - Reviews
  /androidpublisher/v3/applications/{packageName}/reviews/{reviewId}:reply:
    post:
      operationId: androidpublisher.reviews.reply
      summary: Reply reviews
      description: Replies to a single review, or updates an existing reply.
      parameters:
      - name: packageName
        in: path
        required: true
        description: Package name of the app.
        schema:
          type: string
      - name: reviewId
        in: path
        required: true
        description: Unique identifier for a review.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReviewsReplyRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReviewsReplyResponse'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/androidpublisher
      - apiKey: []
      tags:
      - Reviews
components:
  schemas:
    PageInfo:
      properties:
        resultPerPage:
          type: integer
          description: Maximum number of results returned in one page. ! The number of results included in the API response.
          format: int32
        totalResults:
          description: Total number of results available on the backend ! The total number of results in the result set.
          format: int32
          type: integer
        startIndex:
          type: integer
          format: int32
          description: Index of the first result returned in the current page.
      description: Information about the current page. List operations that supports paging return only one "page" of results. This protocol buffer message describes the page that has been returned.
      type: object
    Comment:
      properties:
        developerComment:
          $ref: '#/components/schemas/DeveloperComment'
          description: A comment from a developer.
        userComment:
          $ref: '#/components/schemas/UserComment'
          description: A comment from a user.
      type: object
      description: An entry of conversation between user and developer.
    UserComment:
      description: User entry from conversation between user and developer.
      properties:
        device:
          description: Codename for the reviewer's device, e.g. klte, flounder. May be absent.
          type: string
        deviceMetadata:
          $ref: '#/components/schemas/DeviceMetadata'
          description: Information about the characteristics of the user's device.
        androidOsVersion:
          description: Integer Android SDK version of the user's device at the time the review was written, e.g. 23 is Marshmallow. May be absent.
          format: int32
          type: integer
        originalText:
          description: Untranslated text of the review, where the review was translated. If the review was not translated this is left blank.
          type: string
        appVersionCode:
          description: Integer version code of the app as installed at the time the review was written. May be absent.
          type: integer
          format: int32
        appVersionName:
          description: String version name of the app as installed at the time the review was written. May be absent.
          type: string
        starRating:
          format: int32
          description: The star rating associated with the review, from 1 to 5.
          type: integer
        thumbsDownCount:
          format: int32
          type: integer
          description: Number of users who have given this review a thumbs down.
        text:
          type: string
          description: The content of the comment, i.e. review body. In some cases users have been able to write a review with separate title and body; in those cases the title and body are concatenated and separated by a tab character.
        thumbsUpCount:
          format: int32
          type: integer
          description: Number of users who have given this review a thumbs up.
        reviewerLanguage:
          description: Language code for the reviewer. This is taken from the device settings so is not guaranteed to match the language the review is written in. May be absent.
          type: string
        lastModified:
          $ref: '#/components/schemas/Timestamp'
          description: The last time at which this comment was updated.
      type: object
    ReviewsListResponse:
      type: object
      properties:
        reviews:
          items:
            $ref: '#/components/schemas/Review'
          description: List of reviews.
          type: array
        pageInfo:
          $ref: '#/components/schemas/PageInfo'
          description: Information about the current page.
        tokenPagination:
          $ref: '#/components/schemas/TokenPagination'
          description: Pagination token, to handle a number of products that is over one page.
      description: Response listing reviews.
    ReviewsReplyRequest:
      type: object
      description: Request to reply to review or update existing reply.
      properties:
        replyText:
          description: The text to set as the reply. Replies of more than approximately 350 characters will be rejected. HTML tags will be stripped.
          type: string
    Timestamp:
      type: object
      properties:
        seconds:
          type: string
          description: Represents seconds of UTC time since Unix epoch.
          format: int64
        nanos:
          type: integer
          description: Non-negative fractions of a second at nanosecond resolution. Must be from 0 to 999,999,999 inclusive.
          format: int32
      description: A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970.
    ReviewsReplyResponse:
      type: object
      properties:
        result:
          $ref: '#/components/schemas/ReviewReplyResult'
          description: The result of replying/updating a reply to review.
      description: Response on status of replying to a review.
    ReviewReplyResult:
      description: The result of replying/updating a reply to review.
      properties:
        lastEdited:
          $ref: '#/components/schemas/Timestamp'
          description: The time at which the reply took effect.
        replyText:
          description: The reply text that was applied.
          type: string
      type: object
    DeviceMetadata:
      properties:
        ramMb:
          type: integer
          description: Device RAM in Megabytes, e.g. "2048"
          format: int32
        screenWidthPx:
          format: int32
          type: integer
          description: Screen width in pixels
        screenHeightPx:
          description: Screen height in pixels
          format: int32
          type: integer
        manufacturer:
          type: string
          description: Device manufacturer (e.g. Motorola)
        glEsVersion:
          description: OpenGL version
          type: integer
          format: int32
        cpuMake:
          type: string
          description: Device CPU make, e.g. "Qualcomm"
        nativePlatform:
          description: Comma separated list of native platforms (e.g. "arm", "arm7")
          type: string
        productName:
          type: string
          description: Device model name (e.g. Droid)
        screenDensityDpi:
          type: integer
          description: Screen density in DPI
          format: int32
        deviceClass:
          description: Device class (e.g. tablet)
          type: string
        cpuModel:
          type: string
          description: Device CPU model, e.g. "MSM8974"
      description: Characteristics of the user's device.
      type: object
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    DeveloperComment:
      properties:
        text:
          description: The content of the comment, i.e. reply body.
          type: string
        lastModified:
          $ref: '#/components/schemas/Timestamp'
          description: The last time at which this comment was updated.
      type: object
      description: Developer entry from conversation between user and developer.
    Review:
      properties:
        reviewId:
          type: string
          description: Unique identifier for this review.
        authorName:
          description: The name of the user who wrote the review.
          type: string
        comments:
          type: array
          items:
            $ref: '#/components/schemas/Comment'
          description: A repeated field containing comments for the review.
      type: object
      description: An Android app review.
    TokenPagination:
      type: object
      description: Pagination information returned by a List operation when token pagination is enabled. List operations that supports paging return only one "page" of results. This protocol buffer message describes the page that has been returned. When using token pagination, clients should use the next/previous token to get another page of the result. The presence or absence of next/previous token indicates whether a next/previous page is available and provides a mean of accessing this page. ListRequest.page_token should be set to either next_page_token or previous_page_token to access another page.
      properties:
        previousPageToken:
          type: string
        nextPageToken:
          type: string
          description: Tokens to pass to the standard list field 'page_token'. Whenever available, tokens are preferred over manipulating start_index.
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/androidpublisher: View and manage your Google Play Developer account
externalDocs:
  url: https://developers.google.com/android-publisher
x-provenance:
  method: harvested
  publisher: Google
  source: https://androidpublisher.googleapis.com/$discovery/rest?version=v3
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261111)