Google Play App Chart Lookup

Choose a Google Play list in plain words, such as top free apps, and provide a country or region and language. The lookup handles supported settings, waits for the result, and returns up to 20 apps.

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-list-task-post to retrieve one Google Play app collection. Accept ordinary names for the list, country or region, and language; do not ask the user for internal list names, location codes, language codes, or a result count. Map the requested list to exactly one supported collection: featured apps -> featured; top paid apps -> topselling_paid; top free apps -> topselling_free; new paid apps -> topselling_new_paid; new free apps -> topselling_new_free; apps with the highest sales -> topgrossing; apps rising in the charts -> movers_shakers. If the list choice is unclear, ask the user to choose using these plain-language names. Resolve the country or region and language against the current official DataForSEO Google App Data locations and languages lists; use a unique supported match. If either cannot be mapped clearly or is unsupported, ask a plain-language follow-up rather than guessing or requesting a code. Check Tool availability and price and follow the user’s existing authorization and budget. Send a complete request with the resolved app_collection, location_code, language_code, and depth 20. The Tool submits the request and waits for the completed result. Show app names and store links, then include available list positions, ratings, and prices with their reported scales and currencies. Do not show internal app IDs unless requested. Keep the selected list, country, language, and result receipt time with the snapshot; do not describe it as continuously updated or a complete inventory. Preserve missing, null, zero, and false as distinct values.

Task:
Find the [Top free apps] list on Google Play for [United States] in [English]. Show up to 20 apps, with their place in the list, rating, and price when available.

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 App Chart Lookup

Choose a Google Play list in plain words, such as top free apps, and provide a country or region and language. The lookup handles supported settings, waits for the result, and returns up to 20 apps.

You receive

After successful completion, receive the selected apps with available package IDs, names, store links and recorded chart or list positions. Ratings, review counts and prices with their currencies can also be present. Your Agent can organize the returned details into a compact list.

Start with your task

Find the [Top free apps] list on Google Play for [United States] in [English]. Show up to 20 apps, with their place in the list, rating, and price when available.

What to know

The request is fixed at 20 entries; fewer may be available. Results describe the selected chart or list, location and language context, rather than a continuous live feed or a personalized store screen. The returned time records when the result was received, not when every app listing was updated.

Inputs & outputs

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

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
App list request`request`	`object`	Required	Required complete object containing depth, language_code, location_code and app_collection for one selected Google Play list. Required fields `app_collection, location_code, language_code, depth`
Requested app entries`request.depth`	`integer`	Required	Required integer fixed at 20. The request cannot choose another depth; the available result may contain fewer app records. Fixed value `20`
Language code`request.language_code`	`string`	Required	Required nonempty string, 1–256 characters. Supply a supported Google Play language code, such as en for English, rather than a language name. The example is not a default. Minimum length `1` Maximum length `256`
Location code`request.location_code`	`integer`	Required	Required integer within 1–100000000. Use a supported Google Play location code, such as 2840 for the United States. Being within the numeric range alone does not establish support. Minimum `1` Maximum `100000000`
Chart or list choice`request.app_collection`	`string`	Required	Required nonempty string, 1–256 characters. Documented values are featured, topselling_paid, topselling_free, topselling_new_free, topselling_new_paid, topgrossing and movers_shakers. Choose one; this Tool does not accept a category filter. Minimum length `1` Maximum length `256`

View raw JSON

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

Result schema

Output fields have not been documented yet.

Additional notes

Keep the package ID with an app’s displayed name and store link so similarly named apps are not mixed together. When retaining a list for later use, keep its collection, location, language and receipt time with the records.

Source references: Google Play list request and completed app-list details.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

rank_group gives its position among entries of the same result type; rank_absolute gives its position among all listed apps. The separate position field describes layout alignment. These positions belong to the chosen chart or list and locale; they are not download counts, keyword ranking history or a quality score.

Google Play App Chart Lookup

Google Play App Chart Lookup

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose an app list

Choose a country and language

Read the app list

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose an app list

Choose a country and language

Read the app list

Questions about this tool.

How should I read an app’s list position?

Does a displayed app price include the Tool charge?

Are ratings and review counts the reviews themselves?

Do I need another Tool to collect the result?

What does an empty or short list tell me?