---
title: "Search the app-reviews dataset"
method: GET
path: "/datasets/apps-reviews/search"
tags: ["Datasets"]
---

# Search the app-reviews dataset

`GET /datasets/apps-reviews/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/apps-reviews/search`
- Auth: API key in header `x-api-key`

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).

## Query parameters

- `q` string
- `store` 'ios' | 'android'
- `app_id` string
- `country` string
- `min_score` integer
- `sort` 'recent' | 'score_desc' | 'score_asc' | 'helpful_desc'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

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

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)