Google Play Ranked Search Results by Keyword (US, English)

omnial/google-play-ranked-search-results-us-english

Returns the US Google Play search results, in English, for a keyword: the apps in rank order, each with its rank, package name, app name, developer name, and average star rating (0 to 5) with its rating count where the store shows one, plus the number of apps returned and when the results were retrieved.

activeper callv1

Price

Up to $0.00328 per call; 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.

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-ranked-search-results-us-english" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-play-ranked-search-results-us-english", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-play-ranked-search-results-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.

Charge	Price
Per call	$0.00328

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "keyword",
    "location_code",
    "language_code"
  ],
  "properties": {
    "depth": {
      "enum": [
        10,
        100
      ],
      "type": "integer",
      "default": 100,
      "description": "How many results to collect: 100 (the default) or 10. The store can return more apps than asked for."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "The search term, as a user would type it in Google Play."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The results language; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The store searched; only 2840 (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": {
                "title": {
                  "type": "string",
                  "description": "The app's name."
                },
                "app_id": {
                  "type": "string",
                  "description": "The app's package name, its Google Play id."
                },
                "rating": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Average star rating, 0 to 5."
                    },
                    "votes_count": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Number of ratings; null when the results page shows none (most apps)."
                    }
                  }
                },
                "developer": {
                  "type": "string",
                  "description": "The developer's name."
                },
                "rank_absolute": {
                  "type": "number",
                  "description": "The app's rank, from 1."
                }
              }
            },
            "description": "The apps, in rank order."
          },
          "keyword": {
            "type": "string",
            "description": "The search term, as sent."
          },
          "datetime": {
            "type": "string",
            "description": "When the results were retrieved (UTC)."
          },
          "items_count": {
            "type": "number",
            "description": "The number of entries in items."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}