# Play Store Search API

## Play Store Search API

Use this API to search apps on Google Play Store and fetch full app details.

### Service URL

`https://playstore.udayscripts.in/`

### Request method

`GET`

### Available endpoints

* `/` — API welcome response
* `/search/:query` — search apps by keyword
* `/api/:appId` — get full app details by package name

### Base response

```json
{
  "message": "Welcome to Google Play Store Scraper API",
  "endpoints": {
    "appDetails": "/api/:appId",
    "search": "/search/:query"
  }
}
```

{% tabs %}
{% tab title="Search apps" %}
Use this endpoint to search apps by name or keyword.

#### Endpoint

`/search/:query`

#### Path parameter

**`query`**

The search term you want to look up on Play Store.

Example:

```
free fire
```

#### Example request

```bash
curl "https://playstore.udayscripts.in/search/free%20fire"
```

#### Example URL

```
https://playstore.udayscripts.in/search/free%20fire
```

#### Success response

```json
[
  {
    "title": "Free Fire: Undersea Mystery",
    "appId": "com.dts.freefireth",
    "url": "https://play.google.com/work/apps/details?id=com.dts.freefireth",
    "icon": "https://play-lh.googleusercontent.com/Tzh1vMigK1Cn7_KIaMvKBVQRQapIMWMMqqyA6UqJTAYRpino4vvX6ZvYcVjZ_D8g19-DfHKCVeO2QPWl8vHGzw",
    "developer": "GARENA INTERNATIONAL I",
    "developerId": "GARENA+INTERNATIONAL+I",
    "price": null,
    "free": false,
    "summary": "10-minute Survival Shooter!",
    "scoreText": "4.3",
    "score": 4.2985296
  },
  {
    "title": "Free Fire MAX",
    "appId": "com.dts.freefiremax",
    "url": "https://play.google.com/work/apps/details?id=com.dts.freefiremax",
    "icon": "https://play-lh.googleusercontent.com/EJ83sg58Oo2gAjMHFxFVLM6Z53kuH4_R0M7Yq7gts5fWSIlFchUlmskG1vJKMoncmfOxBXcgJyIaO-nak6sO-MM",
    "developer": "GARENA INTERNATIONAL I",
    "developerId": "GARENA+INTERNATIONAL+I",
    "price": null,
    "free": false,
    "summary": "MAX Battle Royale Experience",
    "scoreText": "4.4",
    "score": 4.435235
  }
]
```

#### Response fields

* `title` — app name
* `appId` — package name
* `url` — Play Store URL
* `icon` — app icon URL
* `developer` — developer name
* `summary` — short app summary
* `scoreText` and `score` — rating values
  {% endtab %}

{% tab title="App details" %}
Use this endpoint to fetch full app details with package name.

#### Endpoint

`/api/:appId`

#### Path parameter

**`appId`**

The app package name.

Example:

```
com.dts.freefireth
```

#### Example request

```bash
curl "https://playstore.udayscripts.in/api/com.dts.freefireth"
```

#### Example URL

```
https://playstore.udayscripts.in/api/com.dts.freefireth
```

#### Success response

```json
{
  "title": "Free Fire: Undersea Mystery",
  "description": "The Undersea Mystery has arrived!",
  "summary": "10-minute Survival Shooter!",
  "installs": "1,000,000,000+",
  "minInstalls": 1000000000,
  "maxInstalls": 2080193515,
  "score": 4.2985296,
  "scoreText": "4.3",
  "ratings": 127702084,
  "reviews": 650643,
  "price": 0,
  "free": true,
  "currency": "USD",
  "priceText": "Free",
  "available": true,
  "offersIAP": true,
  "IAPRange": "$0.09 - $99.99 per item",
  "androidVersion": "5.0",
  "developer": "GARENA INTERNATIONAL I",
  "developerId": "GARENA+INTERNATIONAL+I",
  "developerEmail": "freefire@garena.com",
  "privacyPolicy": "https://content.garena.com/legal/pp/pp_en.html",
  "genre": "Action",
  "icon": "https://play-lh.googleusercontent.com/Tzh1vMigK1Cn7_KIaMvKBVQRQapIMWMMqqyA6UqJTAYRpino4vvX6ZvYcVjZ_D8g19-DfHKCVeO2QPWl8vHGzw",
  "headerImage": "https://play-lh.googleusercontent.com/uHV4VKtO6eD57CR-8TeSPrWfkc-uNkMeMuGyt7mt83OKw3JZA-KliT5a6oKSxehGZEh-",
  "contentRating": "Teen",
  "contentRatingDescription": "Violence, Blood",
  "released": "Dec 7, 2017",
  "version": "1.123.1",
  "appId": "com.dts.freefireth",
  "url": "https://play.google.com/store/apps/details?id=com.dts.freefireth&hl=en&gl=us"
}
```

#### Response includes

* app description and summary
* install and rating data
* price and availability data
* developer details
* category and content rating data
* media fields like `icon`, `headerImage`, `screenshots`, and `video`
  {% endtab %}
  {% endtabs %}

### Notes

* Use URL encoding for search queries with spaces.
* Use the exact package name in `/api/:appId`.
* Search returns a list of apps.
* App details returns one full app object.

{% hint style="success" %}
Need updates or support? Join [@UdayScripts](https://t.me/UdayScripts).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.udayscripts.in/play-store-search-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.