Goole Play

SERP API Google Query Parameters

Configure Google search queries using Thordata’s SERP API, including localization parameters, Play Store Categories, pagination, and "advanced parameter" output options.

q ,Search Query(Required)

Define the search query used for data scraping (Default value: q=pizza). Any keywords in any language are supported.

Example Request: Example using the parameter q: pizza

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1"

Localization

gl ,Country(Optional)

Specify the target country/region for search results (default value: us). Use two-letter country codes(e.g., us, ru, uk).

For the complete list of supported country codes, please refer to: Google’s Country List.

Example Request:

Example results for q : pizza,gl: ru

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"

hl ,Language(Optional)

Set the interface language for search results (default value: en). Adopt standard language code formats (e.g., en, es, zh-CN).

For the complete list of supported language codes, please refer to: Google Language Codes.

Example Request:

Example results for q : pizza,hl: es

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

Search Types

apps_category ,Apps Category(Optional)

The parameter defines the app store category.

Example Request:

Example results for q : pizza,apps_category:ANDROID_WEAR

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "apps_category=ANDROID_WEAR"

Pagination

next_page_token,Next Page Token(Optional)

Parameter defines the next page token. It is used for retrieving the next page results. It shouldn't be used with the section_page_token, see_more_token, and chart parameters.

Example Request:

Example results for q : pizza,next_page_token:GAME

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "next_page_token=GAME"

section_page_token ,Section Page Token(Optional)

Parameter defines the section page token used for retrieving the pagination results from individual sections. This parameter is a safer version of see_more_token, and is found in every row you can paginate into. It shouldn't be used with the next_page_token, see_more_token, and chart parameters

Example Request:

Example results for q : pizza,section_page_token:serpapi_pagination.next_page_token

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "section_page_token=serpapi_pagination.next_page_token"

chart ,Chart(Optional)

The parameter is used to display the top charts. It returns up to 50 results. Each store contains different charts and requires different values ​​to retrieve results. To get the value of a specific chart, you can use our Google Play app store API JSON output: (chart_options[index].value for example chart=topselling_free). It should not be used with section_page_token, see_more_token, and next_page_token parameters.

Example Request:

Example results for q : pizza,chart:top_free

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "chart=top_free"

see_more_token ,See more token(Optional)

This parameter defines the 'see more' token used to retrieve individual partial paginated results. This token is typically found on the next page of results. It should not be used with section_page_token, next_page_token, and chart parameters.

Example Request:

Example results for q : pizza,section_page_token:serpapi_pagination.next_page_token

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "see_more_token=similar_apps"

Advanced Parameters

store_device ,Device(Optional)

The parameter defines the device to use for sorting results. This parameter cannot be used with the apps_category or q parameters. Available options:

phone - Phone devices (default)

tablet - Tablet devices

tv - TV devices

chromebook - Chromebook devices

watch - Watch devices

car - Car devices

Example Request:

Example results for q : pizza,store_device:phone

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "store_device=phone"

age ,Age(Optional)

Parameter defines age subcategory. age works, and should only be used with apps_category=FAMILY(Kids Apps)

It can be set to:

AGE_RANGE1 - Ages up to 5

AGE_RANGE2 - Ages 6-8

AGE_RANGE3 - Ages 9-12

Example Request:

Example results for q : pizza,age:AGE_RANGE1

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "age=AGE_RANGE1"

For further assistance, contact us at [email protected].