Google Play Keyword Ranking Snapshot

Check Google Play search results for a phrase you choose, in the country or region and language you want. The assistant matches supported settings and returns up to 20 apps with available positions and details.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use google-app-searches-task-post through the existing Toolmu connection. Accept one ordinary search phrase, a country or region name, and a language name; do not ask the user for internal codes or a result count. Resolve the requested country/region and language to unique supported DataForSEO App Data location_code and language_code values using the current official lists. If a name is ambiguous or unsupported, ask a plain-language follow-up instead of guessing or requesting codes. Preserve the search phrase as given; if it contains a literal plus or percent character, encode that character for the request internally (%2B or %25) and do not ask the user to type encoded text. Check current Tool availability and price and follow the user’s existing execution authorization and budget. Submit one complete request with keyword, location_code, language_code, and fixed depth 20. This Tool automatically waits for the completed result; no companion Tool is needed. Organize up to 20 returned app names and Google Play links with their reported search positions and available ratings or prices. Do not show app IDs unless requested. Preserve missing and null values, the reported currency, and the receipt time. Describe this as one Google Play search result snapshot for the chosen phrase and locale, not a search-volume estimate, app-quality score, personalized result, or history of ranking changes.

Task:
Search Google Play for [VPN] in [United States] and [English]. Show up to 20 apps, where each appears in the results, and any available ratings or prices.

Paste into your connected AI's conversation.

Connection guide

Up to 0.15 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Google Play Keyword Ranking Snapshot

You receive

Inspect returned apps and their search positions, package IDs and store links. Where available, see app-level average ratings, review totals, listed prices and whether an app is listed as free. Your Agent can organize the candidate apps and these details for comparison.

Start with your task

Search Google Play for [VPN] in [United States] and [English]. Show up to 20 apps, where each appears in the results, and any available ratings or prices.

What to know

The snapshot reflects the selected query, location and language when the task is submitted, with personalized search factors excluded. Processing can take time, and fewer than 20 entries or missing details are possible. This Tool does not provide historical rank tracking, keyword search volumes or Google mobile website rankings.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
App search request`request`	`object`	Required	Required complete object containing keyword, location_code, language_code and depth. Supply all four; this Tool submits the task and waits for its completed result. Required fields `keyword, location_code, language_code, depth`
Requested result depth`request.depth`	`integer`	Required	Required integer fixed at 20. This is the requested number of entries, not an adjustable option or a guarantee of exactly 20 returned apps. Fixed value `20`
Search term`request.keyword`	`string`	Required	Required nonempty string, 1–256 characters. The Tool’s 256-character bound applies even though the supplier accepts longer text. The supplier decodes percent escapes and treats a plus as a space: submit %2B for a literal plus and %25 for a literal percent, keeping the submitted string within 256 characters. Minimum length `1` Maximum length `256`
Language code`request.language_code`	`string`	Required	Required nonempty string, 1–256 characters. Use a supplier-supported App Data language code, such as en, rather than a language name. Length bounds alone do not establish code support. Minimum length `1` Maximum length `256`
Location code`request.location_code`	`integer`	Required	Required integer from 1 to 100000000 that is supported by the supplier’s App Data location list. United States code 2840 is an example, not a default. Supply the code rather than a location name. Minimum `1` Maximum `100000000`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "keyword",
        "location_code",
        "language_code",
        "depth"
      ],
      "properties": {
        "depth": {
          "type": "integer",
          "const": 20
        },
        "keyword": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "language_code": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "location_code": {
          "type": "integer",
          "maximum": 100000000,
          "minimum": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Use package IDs and store links to identify apps when comparing entries. Similar display names alone do not establish that two entries describe the same app.

DataForSEO explains the source in its search request documentation and completed search result documentation.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

rank_group describes position among entries of the same type; rank_absolute describes position among all listed apps. The position field describes visual alignment, such as left, rather than another numeric rank. Keep these meanings separate when organizing the result.

Google Play Keyword Ranking Snapshot

Google Play Keyword Ranking Snapshot

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Enter a search phrase

Choose a country and language

Read the results

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Enter a search phrase

Choose a country and language

Read the results

Questions about this tool.

Which position should I use?

What does the result time tell me?

Are returned entries and app review totals the same count?

How should I read stars and rating votes?

What do the listed price and free flag mean?