Discovery needs no key. Ratings and market analysis are Pro.
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.
openapi: 3.2.0
info:
title: appmanai Public App Metrics API
version: 1.0.0
description: App Store & Google Play data. Reads are `GET` with query parameters and a Bearer API key; the two `generate` endpoints are `POST` with a JSON body.
servers:
- url: https://appmanai.com/api/v1
security:
- bearerAuth: []
tags:
- name: App Metrics
description: Measurements of an app over time. Ratings today; more metrics later.
paths:
/apps/metrics/ratings/worldwide:
get:
tags:
- App Metrics
operationId: appMetricsRatingsWorldwide
summary: 'App Metrics — Current: ratings'
description: An app's rating and per-star vote counts in every country it is listed in.
x-credit-cost: 6
x-appman:
method: POST
path: '{store}/ratings/breakdown'
form:
package: package
parameters:
- $ref: '#/components/parameters/Store'
- $ref: '#/components/parameters/Package'
responses:
'200':
$ref: '#/components/responses/Success'
default:
$ref: '#/components/responses/Error'
/apps/metrics/ratings/history:
get:
tags:
- App Metrics
operationId: appMetricsRatingsHistory
summary: 'App Metrics — History: ratings'
description: An app's average rating and star breakdown over time in one country.
x-credit-cost: 5
x-appman:
method: POST
path: '{store}/{country}/app/user-rating/history'
form:
package: package
parameters:
- $ref: '#/components/parameters/Store'
- $ref: '#/components/parameters/Country'
- $ref: '#/components/parameters/Package'
responses:
'200':
$ref: '#/components/responses/Success'
default:
$ref: '#/components/responses/Error'
components:
responses:
Success:
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
Error:
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
parameters:
Package:
name: Package
in: query
required: false
schema:
type: string
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
Country:
name: Country
in: query
required: false
schema:
type: string
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
Store:
name: Store
in: query
required: false
schema:
type: string
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true