Docs menu

Crawlora Docs

Build an App Review Analysis Workflow

Sync app reviews from app stores, normalize ratings and text, tag feedback topics, and monitor competitors.

Overview

Sync app reviews from app stores, normalize ratings and text, tag feedback topics, and monitor competitors.

What you will build

  • Define app IDs or package names
  • Pull recent reviews
  • Normalize ratings and text
  • Tag topics or sentiment
  • Summarize feedback
  • Monitor competitor changes

APIs used

Only endpoints that exist in the generated endpoint metadata are linked here. Missing optional endpoints are intentionally omitted.

GETAppStoreapiKey3 credits/request

Retrieve App Store reviews

/appstore/reviews

Returns one page of customer reviews for an app. Provide either `id` or `app_id`.

GETGooglePlayapiKey3 credits/request

Retrieve Google Play reviews

/googleplay/reviews

Returns one or more pages of app reviews. Set `paginate=true` to fetch only the requested page.

Data model

FieldNotes
app_idWorkflow field; map to exact endpoint response fields from endpoint docs.
platformWorkflow field; map to exact endpoint response fields from endpoint docs.
review_idWorkflow field; map to exact endpoint response fields from endpoint docs.
ratingWorkflow field; map to exact endpoint response fields from endpoint docs.
titleWorkflow field; map to exact endpoint response fields from endpoint docs.
textWorkflow field; map to exact endpoint response fields from endpoint docs.
authorWorkflow field; map to exact endpoint response fields from endpoint docs.
versionWorkflow field; map to exact endpoint response fields from endpoint docs.
reviewed_atWorkflow field; map to exact endpoint response fields from endpoint docs.
topicWorkflow field; map to exact endpoint response fields from endpoint docs.

Step-by-step workflow

  1. 1.Define app IDs or package names
  2. 2.Pull recent reviews
  3. 3.Normalize ratings and text
  4. 4.Tag topics or sentiment
  5. 5.Summarize feedback
  6. 6.Monitor competitor changes

Example request

This example uses the real Retrieve App Store reviews endpoint. Exact request fields come from the endpoint metadata.

Recipe request

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/appstore/reviews?id=553834731&app_id=com.midasplayer.apps.candycrushsaga&country=us&page=1&sort=mostRecent&lang=en-us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example response

Use endpoint detail pages for exact response schemas. This recipe does not invent response fields.

Generated example response

{
  "code": 200,
  "msg": "OK",
  "data": [
    {
      "id": "review-1",
      "title": "Helpful assistant",
      "score": 5,
      "author": "App Store User",
      "content": "Great for writing and research."
    }
  ]
}

Storage/output suggestion

Write reviews to JSONL for batch analysis or a database table keyed by platform and review ID.

Error handling

  • Validate required inputs before calling Crawlora
  • Retry 429 and temporary 5xx responses with capped backoff
  • Log endpoint, input, timestamp, and request ID when present
  • Treat empty results as a state your application can handle
  • Open /docs/errors for production retry guidance

Rate-limit and credit planning

Estimate usage by multiplying requests by endpoint credit cost. The table below only shows real credit costs available from the billing constants.

EndpointCredit costDocs
Retrieve App Store reviews3 credits/request/docs/AppStore/appstore-reviews
Retrieve Google Play reviews3 credits/request/docs/GooglePlay/googleplay-reviews

Production checklist

  • Keep API keys server-side
  • Use request timeouts
  • Back off on rate limits
  • Store raw responses or source IDs for auditability
  • Monitor credits and failures
  • Avoid unnecessary refreshes
  • Review responsible-use requirements

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

Related APIs and pages

Build this workflow with real endpoint docs

Use this recipe for workflow shape, then rely on endpoint reference pages for exact paths, request schemas, response schemas, and credit costs.