Skip to content
Eden Engine

Google Play Search Terms an App Ranks For (US, English; 1 or 100 Terms)

omnial/google-play-app-ranking-keywords-us-english

Given a Google Play app id, returns how many Google Play search terms the app ranks for in the United States in English, and the first 1 or 100 of those terms in index order. Each term has its estimated monthly search volume and when that was updated, and the app's position in the search results for it (among organic results and overall), with the app's id, title, store address, developer name, rating and rating scale, and its listed price and currency.

activeper resultv1

Price

Up to $0.0164 base + $0.000164 per result; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Google Play

Data from Google Play search results, with search volume estimates.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/google-play-app-ranking-keywords-us-english" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-play-app-ranking-keywords-us-english" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-play-app-ranking-keywords-us-english", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-play-app-ranking-keywords-us-english", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Base price
Charged once per request
$0.0164
Per result
Charged for every result returned
$0.000164
Updated
Oct 14, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "app_id",
    "location_code",
    "language_code",
    "limit"
  ],
  "properties": {
    "limit": {
      "enum": [
        1,
        100
      ],
      "type": "integer",
      "default": 100,
      "description": "The number of search terms to return: 100 (the default) or 1."
    },
    "app_id": {
      "type": "string",
      "minLength": 1,
      "description": "The app's Google Play package id."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "The store language; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "default": 2840,
      "description": "The store market; only 2840 (the United States) is offered."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "keyword_data": {
                  "type": "object",
                  "properties": {
                    "keyword": {
                      "type": "string",
                      "description": "The search term."
                    },
                    "keyword_info": {
                      "type": "object",
                      "properties": {
                        "search_volume": {
                          "type": "number",
                          "description": "The term's estimated monthly search volume."
                        },
                        "last_updated_time": {
                          "type": "string",
                          "description": "When the volume was last updated (UTC)."
                        }
                      }
                    }
                  },
                  "description": "The search term and its volume."
                },
                "ranked_serp_element": {
                  "type": "object",
                  "properties": {
                    "serp_item": {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "description": "The app's store page address."
                        },
                        "price": {
                          "type": "object",
                          "properties": {
                            "current": {
                              "type": "number",
                              "description": "The app's price."
                            },
                            "currency": {
                              "type": "string",
                              "description": "The price's currency code."
                            }
                          }
                        },
                        "title": {
                          "type": "string",
                          "description": "The app's title."
                        },
                        "app_id": {
                          "type": "string",
                          "description": "The app's package id."
                        },
                        "rating": {
                          "type": "object",
                          "properties": {
                            "value": {
                              "type": "number",
                              "description": "The app's rating."
                            },
                            "rating_max": {
                              "type": "number",
                              "description": "The top of the rating scale."
                            }
                          }
                        },
                        "developer": {
                          "type": "string",
                          "description": "The developer's name."
                        },
                        "rank_group": {
                          "type": "number",
                          "description": "The app's position among organic results."
                        },
                        "rank_absolute": {
                          "type": "number",
                          "description": "The app's position among all results."
                        }
                      }
                    }
                  },
                  "description": "The app's search result for the term."
                }
              }
            },
            "description": "The search terms, in index order."
          },
          "app_id": {
            "type": "string",
            "description": "The app's package id, as sent."
          },
          "items_count": {
            "type": "number",
            "description": "The number of entries in items."
          },
          "total_count": {
            "type": "number",
            "description": "How many search terms the app ranks for."
          },
          "language_code": {
            "type": "string",
            "description": "The store language code, as sent."
          },
          "location_code": {
            "type": "number",
            "description": "The store market code, as sent."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}