Docs menu

Datasets API endpoint

Search the app-reviews dataset API

Searches user reviews from the iOS App Store and Google Play (one document per review). Store enum: `ios`, `android`. Sort enum: `recent`, `score_desc`, `score_asc`, `helpful_desc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

GETapiKey1 credit/record returned · minimum 2Datasetsdatasets.reviewsSearchResponseDoc/datasets/apps-reviews/search

Endpoint facts

Method: GET
API path: /datasets/apps-reviews/search
Auth: apiKey
Credits: 1 credit/record returned · minimum 2
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.reviewsSearchResponseDoc

Stored structured dataset search API Try Search the app-reviews dataset API in Playground Datasets API documentation

How this endpoint behaves

Searches user reviews scraped from the iOS App Store and Google Play, stored in a search index. One document per review, so re-crawls accumulate a review corpus per app: full text, star score, author, version, helpful votes, and developer replies. Returns structured review records without triggering live scraping.

Dataset id: apps-reviews

Store enum:

ios
android

Query parameters:

q: optional full-text query over review text, title and author, max 256 characters.
store: optional store enum: ios, android.
app_id: optional exact app filter — the iOS numeric track id or the Android package name, max 128 characters.
country: optional exact storefront country filter, max 128 characters, e.g. us.
min_score: optional minimum star rating, 1 through 5.
sort: optional sort enum: recent (newest first), score_desc, score_asc, helpful_desc (most helpful first). Defaults to recent.
page: optional page number, defaults to 1.
page_size: optional page size, defaults to 20 and maxes at 100.

Response behavior:

The maximum result window is 10000; page * page_size must not exceed 10000.
Invalid enum values return the standard invalid params envelope.
A not-yet-populated index returns an empty items list rather than an error.
Does not trigger live scraping.

Billing

1 credit per record returned, minimum 2. A search that returns 20 records costs 20 credits, a full page of 100 costs 100, and an empty or one-record result costs 2. You are charged for what comes back, not for the page_size you ask for, but your balance must cover the requested page_size for the call to be accepted. The response header x-credit-cost shows what a call was charged.

Live monitoring

Monitored request: GET /datasets/apps-reviews/search?page_size=2
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.19 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /datasets/apps-reviews/search?app_id=284882215&store=ios&page_size=20
Items in items: 20
Fields filled in every checked item: 13

Field	Filled in, of 20 checked	Values in the sample
review_uid	20
store	20
app_id	20
country	20
review_id	20
user_name	20
score	20	1 to 5, median 2
title	20
text	20
url	20	itunes.apple.com
version	20
reviewed_at	20	2026-10-11
last_crawled	20	2026-10-13

Request parameters

Parameter	Type	Required	Default	Description
q	string	No		Full-text query over review text, title and author, max 256 characters
store	string	No		Store enum: ios, android Allowed values: ios, android.
app_id	string	No		Exact app filter — iOS numeric track id or Android package, max 128 characters
country	string	No		Exact storefront country filter, max 128 characters
min_score	integer	No		Minimum star rating, 1 through 5
sort	string	No		Sort enum: recent, score_desc, score_asc, helpful_desc Allowed values: recent, score_desc, score_asc, helpful_desc.
page	integer	No	1	Page number, defaults to 1
page_size	integer	No	20 and maxes at 100	Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/apps-reviews/search?q=coffee&store=ios&country=us&sort=recent&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apps-reviews",
    "items": [
      {
        "review_uid": "ios:284882215:us:7299100412",
        "store": "ios",
        "app_id": "284882215",
        "country": "us",
        "review_id": "7299100412",
        "user_name": "jane_doe",
        "score": 5,
        "title": "Love it",
        "text": "Works flawlessly after the latest update.",
        "version": "451.0",
        "thumbs_up": 12,
        "reviewed_at": "2026-06-18T09:21:00Z",
        "last_crawled": "2026-06-19T02:40:00Z"
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1,
    "sort": "recent"
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.reviewsSearchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	datasets.ReviewsSearchResponse	No
data.dataset	string	No		Identifier of the dataset queried (`apps-reviews`).
data.items	array	No		Matching app review records on this page.
data.items[].app_id	string	No		App id in the store: the numeric App Store id or the Google Play package name.
data.items[].app_uid	string	No		Unique id of the reviewed app in the apps dataset.
data.items[].country	string	No		Storefront country code the review was posted in, for example `us`.
data.items[].last_crawled	string	No		Time the review was last fetched, in UTC (RFC 3339).
data.items[].reply_text	string	No		Developer's public reply to the review. Set for Google Play reviews.
data.items[].review_id	string	No		Review id assigned by the store.
data.items[].review_uid	string	No		Unique review id, combining the store, app id and review id.
data.items[].reviewed_at	string	No		Time the review was posted or last updated, as the store reports it.
data.items[].score	integer	No		Star rating the reviewer gave, from 1 to 5.
data.items[].store	string	No		Which store the review was posted on: `ios` or `android`.
data.items[].text	string	No		Full text of the review.
data.items[].thumbs_up	integer	No		Number of helpful votes the review received. Set for Google Play reviews.
data.items[].title	string	No		Headline the reviewer gave the review.
data.items[].url	string	No		Link to the review on the store.
data.items[].user_name	string	No		Display name of the reviewer.
data.items[].version	string	No		App version the review refers to.
data.page	integer	No		Page number returned.
data.page_size	integer	No		Number of items per page.
data.sort	string	No		Sort order applied.
data.total	integer	No		Total number of records matching the filters.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response

Code examples

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

curl -X GET "https://api.crawlora.net/api/v1/datasets/apps-reviews/search?q=coffee&store=ios&country=us&sort=recent&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Datasets endpoint docs Stored structured dataset search API Stored Datasets List API documentation Airbnb Markets Dataset Facets API documentation Airbnb Markets Dataset Country API documentation Nearby Airbnb Markets Dataset API documentation Airbnb Markets Dataset Search API documentation Facet the Apple Books dataset API documentation

Open in Playground Back to group

Docs menu

Datasets API endpoint

Search the app-reviews dataset API

GETapiKey1 credit/record returned · minimum 2Datasetsdatasets.reviewsSearchResponseDoc/datasets/apps-reviews/search

Endpoint facts

Method: GET
API path: /datasets/apps-reviews/search
Auth: apiKey
Credits: 1 credit/record returned · minimum 2
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.reviewsSearchResponseDoc

Stored structured dataset search API Try Search the app-reviews dataset API in Playground Datasets API documentation

How this endpoint behaves

Dataset id: apps-reviews

Store enum:

ios
android

Query parameters:

q: optional full-text query over review text, title and author, max 256 characters.
store: optional store enum: ios, android.
app_id: optional exact app filter — the iOS numeric track id or the Android package name, max 128 characters.
country: optional exact storefront country filter, max 128 characters, e.g. us.
min_score: optional minimum star rating, 1 through 5.
sort: optional sort enum: recent (newest first), score_desc, score_asc, helpful_desc (most helpful first). Defaults to recent.
page: optional page number, defaults to 1.
page_size: optional page size, defaults to 20 and maxes at 100.

Response behavior:

The maximum result window is 10000; page * page_size must not exceed 10000.
Invalid enum values return the standard invalid params envelope.
A not-yet-populated index returns an empty items list rather than an error.
Does not trigger live scraping.

Billing

Live monitoring

Monitored request: GET /datasets/apps-reviews/search?page_size=2
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.19 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /datasets/apps-reviews/search?app_id=284882215&store=ios&page_size=20
Items in items: 20
Fields filled in every checked item: 13

Field	Filled in, of 20 checked	Values in the sample
review_uid	20
store	20
app_id	20
country	20
review_id	20
user_name	20
score	20	1 to 5, median 2
title	20
text	20
url	20	itunes.apple.com
version	20
reviewed_at	20	2026-10-11
last_crawled	20	2026-10-13

Request parameters

Parameter	Type	Required	Default	Description
q	string	No		Full-text query over review text, title and author, max 256 characters
store	string	No		Store enum: ios, android Allowed values: ios, android.
app_id	string	No		Exact app filter — iOS numeric track id or Android package, max 128 characters
country	string	No		Exact storefront country filter, max 128 characters
min_score	integer	No		Minimum star rating, 1 through 5
sort	string	No		Sort enum: recent, score_desc, score_asc, helpful_desc Allowed values: recent, score_desc, score_asc, helpful_desc.
page	integer	No	1	Page number, defaults to 1
page_size	integer	No	20 and maxes at 100	Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/apps-reviews/search?q=coffee&store=ios&country=us&sort=recent&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apps-reviews",
    "items": [
      {
        "review_uid": "ios:284882215:us:7299100412",
        "store": "ios",
        "app_id": "284882215",
        "country": "us",
        "review_id": "7299100412",
        "user_name": "jane_doe",
        "score": 5,
        "title": "Love it",
        "text": "Works flawlessly after the latest update.",
        "version": "451.0",
        "thumbs_up": 12,
        "reviewed_at": "2026-06-18T09:21:00Z",
        "last_crawled": "2026-06-19T02:40:00Z"
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1,
    "sort": "recent"
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.reviewsSearchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	datasets.ReviewsSearchResponse	No
data.dataset	string	No		Identifier of the dataset queried (`apps-reviews`).
data.items	array	No		Matching app review records on this page.
data.items[].app_id	string	No		App id in the store: the numeric App Store id or the Google Play package name.
data.items[].app_uid	string	No		Unique id of the reviewed app in the apps dataset.
data.items[].country	string	No		Storefront country code the review was posted in, for example `us`.
data.items[].last_crawled	string	No		Time the review was last fetched, in UTC (RFC 3339).
data.items[].reply_text	string	No		Developer's public reply to the review. Set for Google Play reviews.
data.items[].review_id	string	No		Review id assigned by the store.
data.items[].review_uid	string	No		Unique review id, combining the store, app id and review id.
data.items[].reviewed_at	string	No		Time the review was posted or last updated, as the store reports it.
data.items[].score	integer	No		Star rating the reviewer gave, from 1 to 5.
data.items[].store	string	No		Which store the review was posted on: `ios` or `android`.
data.items[].text	string	No		Full text of the review.
data.items[].thumbs_up	integer	No		Number of helpful votes the review received. Set for Google Play reviews.
data.items[].title	string	No		Headline the reviewer gave the review.
data.items[].url	string	No		Link to the review on the store.
data.items[].user_name	string	No		Display name of the reviewer.
data.items[].version	string	No		App version the review refers to.
data.page	integer	No		Page number returned.
data.page_size	integer	No		Number of items per page.
data.sort	string	No		Sort order applied.
data.total	integer	No		Total number of records matching the filters.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response

Code examples

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

curl -X GET "https://api.crawlora.net/api/v1/datasets/apps-reviews/search?q=coffee&store=ios&country=us&sort=recent&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Search the app-reviews dataset API

Endpoint facts

How this endpoint behaves

Billing

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Search the app-reviews dataset API

Endpoint facts

How this endpoint behaves

Billing

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related