# Google Play App Listings Search API (https://www.socialcrawl.dev/platforms/google_play/app-listings-search)

> Searches DataForSEO's real-time, filterable Google Play listings database by app title (and/or description) and returns a unified AppList. Unlike the store-chart endpoints this one is the ONE true paginator — page with `limit` (≤50) + `offset` (then `offset_token` for deeper) and read the platform-wide `total`. Premium-tier because the upstream bills per returned item. Sourced from DataForSEO's synchronous live App Data database.

TL;DR: `GET /v1/google_play/app-listings-search` costs 10 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `title` | yes | App title to search for (e.g. 'photo editor'). |
| `description` | no | Optional app-description text to match. |
| `limit` | no | Apps per page (1–50, default 20). |
| `offset` | no | Pagination offset (up to 10,000; use offset_token beyond). |
| `offset_token` | no | Opaque deep-pagination cursor from a prior response. |
| `filters` | no | Advanced DataForSEO filter expression as a JSON array. |
| `country` | no | Storefront country as a DFS location name or numeric code. Defaults to the US. |
| `language` | no | Language code (e.g. 'en'). Defaults to 'en'. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google_play/app-listings-search?title=photo%20editor" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I query the Google Play app listings database via API?

Send a GET request to /v1/google_play/app-listings-search with a query or title plus optional filters. Unlike live app search, this hits a stored, paginated listings database and returns a platform-wide total alongside the matching apps.

### What makes app-listings-search different from app search?

App search runs a live keyword query and returns ranked store results. App-listings-search queries a stored database with pagination, filters, and a total match count — built for bulk analysis and dataset building rather than store-style lookup.

### What does the platform-wide total give me?

Each response includes the total number of matching listings across the database, not just the current page. That total lets you size a result set, paginate confidently, and report how many apps match a filter — unusual for a developer API.

### How much does the app listings endpoint cost?

App-listings-search runs on the premium tier at 10 credits per call, reflecting the paginated database query behind it. New accounts get 100 free credits with no card, and an empty result is refunded automatically.

### Can I paginate and filter the listings?

Yes. Pagination parameters page through the full result set, and filters narrow listings before the page is returned. Each listing carries its package name, so you can hand results straight to app-info or app-reviews.

See the full Google Play API: https://www.socialcrawl.dev/platforms/google_play

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to query a paginated Google Play app listings database via API
- How does the SocialCrawl Google Play listings API return a platform-wide total?