App review mining & ASO
Pull App Store (iOS) and Google Play (Android) app details, reviews, ratings,
rankings, and similar-app lists as normalized JSON from the Crawlora API.
When to use this skill
- "What are the reviews / ratings for ?"
- "How is ranked?" / "top apps in ."
- "Find apps similar to " / competitive ASO research.
- "Pull this app's details / privacy / version history."
- Building an app-review sentiment or competitor-tracking pipeline.
Setup (one-time)
- Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
- Set
CRAWLORA_API_KEY in the environment before running the helper.
- The helper reads
CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.
How it works
Choose the store (both have parallel endpoints), then the job:
- Find the app —
/appstore/search?term=... or /googleplay/search?q=...
to resolve the app id / bundle id.
- Details —
/appstore/app, /googleplay/app for metadata, rating summary,
description, and developer.
- Reviews —
/appstore/reviews, /googleplay/reviews (paginate) for the
review text, score, and date to mine sentiment and themes.
- Rankings —
/appstore/list, /googleplay/list for store charts by category.
- Competitors —
/appstore/similar, /googleplay/similar for similar apps.
Full endpoint list, methods, and params: reference/endpoints.md.
Calling the API
# Find an app, then pull its reviews (GET, key=value params):
scripts/crawlora.sh /appstore/search term="notion" | jq '.'
scripts/crawlora.sh /appstore/reviews id=1232780281 country=us | jq '.data'
scripts/crawlora.sh /googleplay/search term="notion" | jq '.'
scripts/crawlora.sh /googleplay/reviews app_id="notion.id" | jq '.'
Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.
Endpoint reference
See reference/endpoints.md for every App Store and
Google Play endpoint this skill uses (method, path, params, description).
Examples
- Review sentiment: resolve the app id via search →
/appstore/reviews
(paginate) → classify each review's sentiment and summarize top complaints/praise.
- Cross-store compare: pull
/appstore/app and /googleplay/app for the same
product to compare ratings and review volume across platforms.
- Category ranking watch:
/googleplay/list for a category to track where an
app sits in the charts over time.
Notes & limits
- Credits / pay-on-success: billed only on
2xx; free tier 2,000 credits/mo.
Key at https://crawlora.net.
- Public data only — public store pages; respect Apple's and Google's terms.
- Security: key lives in
CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
- Reviews are paginated and locale-specific — pass
country/page to widen coverage.
1---2name: app-review-mining3description: Mines App Store and Google Play data via the Crawlora API — app details, reviews, ratings, store rankings, and similar apps — as clean JSON. Use when the user wants mobile-app reviews, ratings, store charts/rankings, or competitive ASO (app store optimization) research without scraping store pages.4---56# App review mining & ASO78Pull App Store (iOS) and Google Play (Android) app details, reviews, ratings,9rankings, and similar-app lists as normalized JSON from the Crawlora API.1011## When to use this skill1213- "What are the reviews / ratings for <app>?"14- "How is <app> ranked?" / "top apps in <category>."15- "Find apps similar to <app>" / competitive ASO research.16- "Pull this app's details / privacy / version history."17- Building an app-review sentiment or competitor-tracking pipeline.1819## Setup (one-time)2021- Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).22- Set `CRAWLORA_API_KEY` in the environment before running the helper.23- The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`.2425## How it works2627Choose the store (both have parallel endpoints), then the job:28291. **Find the app** — `/appstore/search?term=...` or `/googleplay/search?q=...`30 to resolve the app id / bundle id.312. **Details** — `/appstore/app`, `/googleplay/app` for metadata, rating summary,32 description, and developer.333. **Reviews** — `/appstore/reviews`, `/googleplay/reviews` (paginate) for the34 review text, score, and date to mine sentiment and themes.354. **Rankings** — `/appstore/list`, `/googleplay/list` for store charts by category.365. **Competitors** — `/appstore/similar`, `/googleplay/similar` for similar apps.3738Full endpoint list, methods, and params: [`reference/endpoints.md`](reference/endpoints.md).3940## Calling the API4142```sh43# Find an app, then pull its reviews (GET, key=value params):44scripts/crawlora.sh /appstore/search term="notion" | jq '.'45scripts/crawlora.sh /appstore/reviews id=1232780281 country=us | jq '.data'4647scripts/crawlora.sh /googleplay/search term="notion" | jq '.'48scripts/crawlora.sh /googleplay/reviews app_id="notion.id" | jq '.'49```5051Use `scripts/crawlora.sh` for all requests; it keeps the API key out of command-line arguments.525354## Endpoint reference5556See [`reference/endpoints.md`](reference/endpoints.md) for every App Store and57Google Play endpoint this skill uses (method, path, params, description).5859## Examples6061- **Review sentiment:** resolve the app id via search → `/appstore/reviews`62 (paginate) → classify each review's sentiment and summarize top complaints/praise.63- **Cross-store compare:** pull `/appstore/app` and `/googleplay/app` for the same64 product to compare ratings and review volume across platforms.65- **Category ranking watch:** `/googleplay/list` for a category to track where an66 app sits in the charts over time.6768## Notes & limits6970- **Credits / pay-on-success:** billed only on `2xx`; free tier 2,000 credits/mo.71 Key at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).72- **Public data only** — public store pages; respect Apple's and Google's terms.73- **Security:** key lives in `CRAWLORA_API_KEY` only — never hardcode, query-param, or commit it.74- Reviews are paginated and locale-specific — pass `country`/`page` to widen coverage.
Crawlora-org