AppSkyline App Rankings

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId', 'searchTerms'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}, 'country': {'type': 'string', 'maxLength': 10, 'description': 'Two-letter store country code such as US; without one the weekly rank check skips this keyword'}, 'language': {'type': 'string', 'maxLength': 32, 'description': 'Two-letter language code such as en'}, 'searchTerms': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Keyword phrase to track, as users type it in the store, 1 to 200 characters'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'keyword'], 'properties': {'status': {'type': 'string', 'const': 'added'}, 'keyword': {'type': 'object', 'required': ['id', 'appId', 'term', 'language', 'country'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'term': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'country': {'anyOf': [{'type': 'string', 'maxLength': 10}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Keyword id'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'keywordId'], 'properties': {'status': {'enum': ['deleted', 'not-found'], 'type': 'string'}, 'keywordId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'app'], 'properties': {'app': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'defaultLocale', 'locales', 'iosAppStoreId', 'macosAppStoreId', 'googlePlayStorePackage', 'windowsStoreProductId', 'creationTime', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'creationTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'iosAppStoreId': {'$ref': '#/properties/app/anyOf/0/properties/name'}, 'macosAppStoreId': {'$ref': '#/properties/app/anyOf/0/properties/name'}, 'windowsStoreProductId': {'$ref': '#/properties/app/anyOf/0/properties/name'}, 'googlePlayStorePackage': {'$ref': '#/properties/app/anyOf/0/properties/name'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Null when the app is not in the signed-in account'}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId', 'store'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'description': 'Rolling window of the last 1 to 365 days, used when no dates are given; omit dates and days for every synced day', 'exclusiveMinimum': 0}, 'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string', 'description': 'Store to summarize: ios-app-store, macos-app-store, google-play or microsoft-store'}, 'endDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last day of the window as YYYY-MM-DD; applies only together with startDate'}, 'startDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'First day of the window as YYYY-MM-DD; applies only together with endDate'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'appId', 'store', 'dataThrough', 'lastSyncedAt', 'totals', 'totalsTruncated', 'topTerritories', 'dailySeries'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string'}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'value'], 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'value': {'type': 'number', 'maximum': 1000000000000000, 'minimum': -1000000000000000}}, 'additionalProperties': False}, 'maxItems': 30, 'description': 'Store-reported totals for the window; metric names differ by store'}, 'dailySeries': {'anyOf': [{'type': 'object', 'required': ['name', 'rows', 'totalRows', 'totalRowsIsLowerBound', 'truncated'], 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'metrics'], 'properties': {'date': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'metrics': {'type': 'array', 'items': {'$ref': '#/properties/totals/items'}, 'maxItems': 6}}, 'additionalProperties': False}, 'maxItems': 30}, 'totalRows': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'truncated': {'type': 'boolean'}, 'totalRowsIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'The most recent 30 days of one daily metric series'}, 'dataThrough': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastSyncedAt': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'topTerritories': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100}, 'maxItems': 8, 'description': 'Up to 8 leading countries or territories by downloads or installs'}, 'totalsTruncated': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId', 'store', 'term', 'country'], 'properties': {'term': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Search term to read history for, 1 to 200 characters'}, 'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}, 'limit': {'type': 'integer', 'maximum': 365, 'description': 'Snapshots to return, newest first, from 1 to 365; defaults to 365', 'exclusiveMinimum': 0}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string', 'description': 'Store to read: ios-app-store, macos-app-store, google-play or microsoft-store; the app needs an id on that store'}, 'country': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': 'Two-letter store country code such as US or IT (required)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'app', 'store', 'term', 'country', 'snapshots', 'returned', 'totalSnapshots', 'totalSnapshotsIsLowerBound', 'truncated'], 'properties': {'app': {'anyOf': [{'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}, {'type': 'null'}]}, 'term': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string'}, 'status': {'enum': ['found', 'app-not-found', 'store-not-configured', 'no-history'], 'type': 'string'}, 'country': {'anyOf': [{'type': 'string', 'maxLength': 10}, {'type': 'null'}]}, 'returned': {'type': 'integer', 'maximum': 365, 'minimum': 0}, 'snapshots': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'rank', 'resultsScanned', 'resultsTruncated'], 'properties': {'date': {'anyOf': [{'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, {'type': 'null'}]}, 'rank': {'anyOf': [{'type': 'integer', 'maximum': 200, 'exclusiveMinimum': 0}, {'type': 'null'}]}, 'resultsScanned': {'type': 'integer', 'maximum': 200, 'minimum': 0}, 'resultsTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 365, 'description': 'One row per stored search snapshot, newest first; rank is null when the app was not in that snapshot'}, 'truncated': {'type': 'boolean'}, 'totalSnapshots': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'totalSnapshotsIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['terms', 'country'], 'properties': {'lang': {'type': 'string', 'maxLength': 32, 'description': 'Two-letter language code such as en or it; optional'}, 'terms': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[^,]+$', 'maxLength': 200, 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Keyword ideas to look up in one batch, 1 to 50 terms of up to 200 characters, none containing a comma'}, 'country': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'maxLength': 2, 'minLength': 2, 'description': 'Two-letter country code such as US or IT (required)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'country', 'lang', 'keywords', 'returned', 'truncated'], 'properties': {'lang': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'keywords': {'type': 'array', 'items': {'type': 'object', 'required': ['keyword', 'searchVolume', 'keywordDifficulty', 'cpc', 'competition', 'fetchedAt'], 'properties': {'cpc': {'anyOf': [{'type': 'number', 'maximum': 1000000, 'minimum': 0}, {'type': 'null'}]}, 'keyword': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'fetchedAt': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'competition': {'anyOf': [{'type': 'string', 'maxLength': 50}, {'type': 'null'}]}, 'searchVolume': {'anyOf': [{'type': 'integer', 'maximum': 1000000000, 'minimum': 0}, {'type': 'null'}]}, 'keywordDifficulty': {'anyOf': [{'type': 'number', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Google web-search demand per term from the shared 30-day cache, highest volume first; a proxy for interest, not app-store search counts'}, 'returned': {'type': 'integer', 'maximum': 50, 'minimum': 0}, 'truncated': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId', 'store', 'term'], 'properties': {'num': {'type': 'integer', 'default': 50, 'maximum': 200, 'description': 'How many search results to scan for the app, from 1 to 200; defaults to 50', 'exclusiveMinimum': 0}, 'lang': {'type': 'string', 'maxLength': 32, 'description': 'Two-letter language code such as en or it; defaults to en except on Google Play, which uses the store default'}, 'term': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Search term to check, 1 to 200 characters'}, 'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string', 'description': 'Store to check: ios-app-store, macos-app-store, google-play or microsoft-store; the app needs an id on that store'}, 'country': {'type': 'string', 'maxLength': 10, 'description': 'Two-letter store country code such as US or IT; defaults to US'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'app', 'term', 'store', 'country', 'lang', 'rank', 'resultsScanned'], 'properties': {'app': {'anyOf': [{'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}, {'type': 'null'}]}, 'lang': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'rank': {'anyOf': [{'type': 'integer', 'maximum': 200, 'exclusiveMinimum': 0}, {'type': 'null'}], 'description': '1-based position; null unless status is ranked'}, 'term': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string'}, 'status': {'enum': ['ranked', 'not-ranked', 'app-not-found', 'store-not-configured'], 'type': 'string'}, 'country': {'anyOf': [{'type': 'string', 'maxLength': 10}, {'type': 'null'}]}, 'resultsScanned': {'type': 'integer', 'maximum': 200, 'minimum': 0, 'description': 'How many results were scanned; report a rank as #N of this'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store', 'storeId'], 'properties': {'lang': {'type': 'string', 'maxLength': 32, 'description': "Two-letter language code such as en or it; defaults to the store's own default"}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string', 'description': 'Store to read: ios-app-store, macos-app-store, google-play or microsoft-store'}, 'country': {'type': 'string', 'maxLength': 10, 'description': "Two-letter store country code such as US or IT; defaults to the store's own default"}, 'storeId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "The app's id in that store: numeric Apple id, Google Play package name such as com.example.app, or Microsoft Store product id"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'store', 'storeId', 'country', 'lang', 'listing'], 'properties': {'lang': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string'}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}, 'country': {'anyOf': [{'type': 'string', 'maxLength': 10}, {'type': 'null'}]}, 'listing': {'anyOf': [{'type': 'object', 'required': ['id', 'title', 'developer', 'developerId', 'score', 'ratings', 'price', 'free', 'currency', 'version', 'released', 'updated', 'requiredOsVersion', 'genres', 'screenshotCount', 'description', 'releaseNotes'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'free': {'type': ['boolean', 'null']}, 'price': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1000000, 'minimum': 0}, {'type': 'null'}], 'description': 'Average rating as the store reports it'}, 'title': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'genres': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100}, 'maxItems': 20}, 'ratings': {'anyOf': [{'type': 'integer', 'maximum': 1000000000000, 'minimum': 0}, {'type': 'null'}]}, 'updated': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'version': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'currency': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'released': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'developer': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 600}, {'type': 'null'}]}, 'developerId': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'releaseNotes': {'anyOf': [{'type': 'string', 'maxLength': 600}, {'type': 'null'}]}, 'screenshotCount': {'type': 'integer', 'maximum': 10000, 'minimum': 0}, 'requiredOsVersion': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'The live public listing; description and release notes are cut to 600 characters. Null when the store has no app with that id.'}, 'storeId': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId', 'store'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string', 'description': 'Store listing to read: ios-app-store, macos-app-store, google-play or microsoft-store'}, 'locale': {'type': 'string', 'maxLength': 32, 'description': 'Only this locale, written as in the listing such as en-US or it; every synced locale when absent'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'appId', 'store', 'localeFilter', 'listings', 'returned', 'truncated'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string'}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'listings': {'type': 'array', 'items': {'type': 'object', 'required': ['locale', 'name', 'subtitle', 'keywords', 'keywordCharacters', 'promotionalText', 'whatsNew', 'description', 'version', 'state', 'lastSyncedAt'], 'properties': {'name': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'locale': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'version': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'keywords': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'subtitle': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'whatsNew': {'anyOf': [{'type': 'string', 'maxLength': 600}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 600}, {'type': 'null'}]}, 'lastSyncedAt': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'promotionalText': {'anyOf': [{'type': 'string', 'maxLength': 600}, {'type': 'null'}]}, 'keywordCharacters': {'anyOf': [{'type': 'integer', 'maximum': 200, 'minimum': 0}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Metadata as last synced into AppSkyline, one row per locale; it may differ from what the store shows now. Long texts are cut to 600 characters.'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'truncated': {'type': 'boolean'}, 'localeFilter': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'apps', 'truncated'], 'properties': {'apps': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'defaultLocale', 'iosAppStoreId', 'macosAppStoreId', 'googlePlayStorePackage', 'windowsStoreProductId'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'name': {'$ref': '#/properties/apps/items/properties/id'}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'iosAppStoreId': {'$ref': '#/properties/apps/items/properties/id'}, 'macosAppStoreId': {'$ref': '#/properties/apps/items/properties/id'}, 'windowsStoreProductId': {'$ref': '#/properties/apps/items/properties/id'}, 'googlePlayStorePackage': {'$ref': '#/properties/apps/items/properties/id'}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Apps the signed-in account can access, at most 100'}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'truncated': {'type': 'boolean', 'description': 'True when the account has more than 100 apps'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid); the app needs a Google Play service account in AppSkyline'}, 'token': {'type': 'string', 'maxLength': 2000, 'description': 'nextPageToken from the previous page; absent for the first page'}, 'maxResults': {'type': 'integer', 'maximum': 100, 'description': 'Reviews to return per page, from 1 to 100', 'exclusiveMinimum': 0}, 'translationLanguage': {'type': 'string', 'maxLength': 32, 'description': 'Translate review text into this language, such as en; omit to keep the original language'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'appId', 'reviews', 'returned', 'nextPageToken', 'truncated'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'status': {'enum': ['available', 'empty', 'not-configured'], 'type': 'string'}, 'reviews': {'type': 'array', 'items': {'type': 'object', 'required': ['reviewId', 'author', 'stars', 'date', 'version', 'device', 'language', 'replied', 'text'], 'properties': {'date': {'anyOf': [{'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, {'type': 'null'}]}, 'text': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'stars': {'anyOf': [{'type': 'integer', 'maximum': 5, 'minimum': 1}, {'type': 'null'}]}, 'author': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'device': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'replied': {'type': 'boolean'}, 'version': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'reviewId': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Reviews created or edited in the last 7 days, as the Google Play API returns them; review text is cut to 300 characters'}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'truncated': {'type': 'boolean'}, 'nextPageToken': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}], 'description': 'Pass as token to get the next page; null on the last page'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['appId'], 'properties': {'skip': {'type': 'integer', 'maximum': 1000000, 'minimum': 0, 'description': 'Keywords to skip before the first one returned, for paging; defaults to 0'}, 'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}, 'limit': {'type': 'integer', 'maximum': 500, 'description': 'Keywords to return, from 1 to 500; omit for all tracked keywords, capped at 500', 'exclusiveMinimum': 0}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'keywords', 'offset', 'returned', 'truncated'], 'properties': {'offset': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'keywords': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'term', 'language', 'country', 'bid'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'bid': {'anyOf': [{'type': 'number', 'maximum': 1000000000000, 'minimum': 0}, {'type': 'null'}], 'description': 'Bid amount stored for the keyword; null when none is set'}, 'term': {'$ref': '#/properties/keywords/items/properties/id'}, 'country': {'anyOf': [{'type': 'string', 'maxLength': 10}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 500, 'description': 'Tracked keywords for the app, at most 500 per call'}, 'returned': {'type': 'integer', 'maximum': 500, 'minimum': 0}, 'truncated': {'type': 'boolean', 'description': 'True when more than 500 keywords matched; page with skip'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['store', 'term'], 'properties': {'num': {'type': 'integer', 'maximum': 200, 'description': 'Number of results to return, from 1 to 200; defaults to 10', 'exclusiveMinimum': 0}, 'lang': {'type': 'string', 'maxLength': 32, 'description': 'Two-letter language code such as en or it; defaults to en except on Google Play, which uses the store default'}, 'term': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Search term as a user would type it in the store, 1 to 200 characters'}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string', 'description': 'Store to search: ios-app-store, macos-app-store, google-play or microsoft-store'}, 'country': {'type': 'string', 'maxLength': 10, 'description': 'Two-letter store country code such as US or IT; defaults to US'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'store', 'term', 'country', 'lang', 'results', 'truncated'], 'properties': {'lang': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'term': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'store': {'enum': ['ios-app-store', 'macos-app-store', 'google-play', 'microsoft-store'], 'type': 'string'}, 'status': {'enum': ['found', 'empty'], 'type': 'string'}, 'country': {'anyOf': [{'type': 'string', 'maxLength': 10}, {'type': 'null'}]}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['rank', 'id', 'title', 'score', 'developer'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 300}, {'type': 'null'}]}, 'rank': {'type': 'integer', 'maximum': 200, 'exclusiveMinimum': 0}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1000000, 'minimum': 0}, {'type': 'null'}], 'description': 'Rating score as the store reports it'}, 'title': {'$ref': '#/properties/results/items/properties/id'}, 'developer': {'$ref': '#/properties/results/items/properties/id'}}, 'additionalProperties': False}, 'maxItems': 200, 'description': 'Live search results in store rank order; nothing is stored in AppSkyline'}, 'truncated': {'type': 'boolean', 'description': 'True when the store returned more than 200 results'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['appId'], 'properties': {'appId': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'AppSkyline app id (uuid)'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['app', 'keywordCount', 'storeCount', 'keywords'], 'properties': {'app': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'defaultLocale', 'locales', 'iosAppStoreId', 'macosAppStoreId', 'googlePlayId', 'microsoftStoreId'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'locales': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 100}, 'googlePlayId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'iosAppStoreId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'macosAppStoreId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'microsoftStoreId': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'keywords': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'term', 'language', 'country'], 'properties': {'id': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'term': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}]}, 'country': {'anyOf': [{'type': 'string', 'maxLength': 10}, {'type': 'null'}]}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'The first 50 tracked keywords; keywordCount has the total'}, 'storeCount': {'type': 'integer', 'maximum': 4, 'minimum': 0}, 'keywordCount': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}}, 'additionalProperties': False}