Google Play Developer Reviews API
The Reviews API from Google Play Developer — 3 operation(s) for reviews.
The Reviews API from Google Play Developer — 3 operation(s) for reviews.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/google-play:google-play-reviews-api"
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.
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: 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)