# Search Google Play apps

Returns the Google Play apps that match a search, in the sections the store shows them. Use it to see which apps rank for a query.

Tool `google-play.search.apps` on Google Play. Contract version 1, released 2026-10-27.

## Example call

Over REST, send the input in the body. Over MCP, pass the same input to `call_tool`.

cURL:

```bash
curl https://api.voxoria.ai/v1/tools/google-play.search.apps/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"language learning"}}'
```

Python:

```python
import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google-play.search.apps/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"query": "language learning"}},
    timeout=60,
)
print(response.json())
```

TypeScript:

```ts
const response = await fetch("https://api.voxoria.ai/v1/tools/google-play.search.apps/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"query": "language learning"}}),
});
console.log(await response.json());
```

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "google-play.search.apps",
    "input": {
      "query": "language learning"
    }
  }
}
```

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | Yes |  | What to search for, such as an app's name or a kind of app. 1 to 2048 characters. |
| `country` | string | No | `us` | Two-letter ISO 3166-1 country code of the storefront. Case-insensitive. One of the 249 values of the `countries` list: ISO 3166-1 alpha-2 country codes, lowercase. |
| `language` | string | No | `en` | Two-letter ISO 639-1 language code of the storefront. Case-insensitive. One of the 184 values of the `languages` list: ISO 639-1 two-letter language codes, lowercase. |
| `next_page_token` | string | No |  | Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same query, country and language. Not with section_page_token. |
| `section_page_token` | string | No |  | Loads more of one section. Take it from that section's next_page_token, and send the same query, country and language. Not with next_page_token. |

## Output

A successful call returns these blocks in its `output`. A field not marked required can be `null`.

### sections

A list of rows. Always present, possibly empty. The results, in the sections the store groups them in, in order.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | No | The section's heading, such as "Similar apps". Null for the main section, which has none. |
| `next_page_token` | string | No | Send as section_page_token to load more of this section, with the same query, country and language. Null when the section has no more. |
| `results` | array of object | Yes |  |
| `results.product_id` | string | Yes | Google Play's ID of the app. Send as product_id to google-play.product or google-play.reviews. |
| `results.title` | string | Yes |  |
| `results.url` | string | No | Address of the app's page on Google Play. |
| `results.description` | string | No |  |
| `results.image_url` | string | No | Address of the app's icon. |
| `results.developer_name` | string | No |  |
| `results.rating` | number | No | Average rating, out of 5. |
| `results.category` | string | No | The app's category, as the store names it, such as "Education". |
| `results.installs` | string | No | Install count as the store shows it, such as "10,000,000+". Not parsed. |
| `results.content_rating` | string | No | Age rating as the store shows it, such as "Everyone". |
| `results.price` | string | No | The price as the store shows it, with its currency symbol, such as "$4.99". Not parsed. |
| `results.price_amount` | number | No | The price as a number, in currency. 0 for a free app. |
| `results.currency` | string | No | Three-letter ISO 4217 currency code of price_amount. |

### top_result

One object. Can be `null`. The app Google Play features above the results when the query names one.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `product_id` | string | Yes | Google Play's ID of the app. |
| `title` | string | Yes |  |
| `url` | string | No | Address of the app's page on Google Play. |
| `description` | string | No |  |
| `image_url` | string | No | Address of the app's icon. |
| `developer_name` | string | No |  |
| `rating` | number | No | Average rating, out of 5. |
| `review_count` | integer | No | Number of ratings the average is from. |
| `installs` | string | No | Install count as the store shows it, such as "500M+". Not parsed. |
| `install_count` | integer | No | Install count as a number. |
| `content_rating` | string | No | Age rating as the store shows it, such as "Everyone". |

### pagination

One object. Can be `null`. How to fetch the next page. Null on the last page.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `next_page_token` | string | Yes | Send as next_page_token to fetch the next page. |

## Example output

The `output` of a real call, each list cut to 3 items.

```json
{
  "sections": [
    {
      "title": null,
      "next_page_token": null,
      "results": [
        {
          "product_id": "com.duolingo",
          "title": "Duolingo: Learn Languages",
          "url": "https://play.google.com/store/apps/details?id=com.duolingo",
          "description": "Learn a new language, chess, math & more with the world’s most downloaded education app! Duolingo is the fun, free app for learning 40+ languages through quick, bite-sized lessons. Practice speaking, reading, listening & writing in languages like Spanish, French, German and more. Designed by learning experts & loved by hundreds of millions worldwide, Duolingo helps you prepare for real conversations in Spanish, French, Chinese, Italian, German, English & more. Now you can also learn Math, Music & Chess the Duolingo way, with interactive online play & fun lessons for all levels. Whether you want to take lessons to improve languages like Spanish, French or German, or sharpen your skills with math games, music & chess, Duolingo makes learning effective & fun. ♟️Chess: Master moves, level up your game & play online in our brand new course. Learn the basics, practice fun challenges & improve your strategy with guided lessons. Whether you're new to chess or already play online, our step-by-step lessons help you build real skills. 🧮 Math: Build real-world math skills: from calculating tips to identifying patterns, sharpen your mental math in our math course using math games. Practice foundational topics like multiplication, fractions, geometry & more. 🎵 Music: Learn how to read music & play popular songs on your device in our Music course, no instrument needed! Using an on-screen keyboard, you’ll practice bit-by-bit. 🤖 AI: Practice real conversations with AI-powered features in Duolingo Max. Use AI-powered Video Call & Roleplay for extra language practice in Spanish, French, German & more, with AI feedback to help improve your language skills. It’s like having a language tutor in your pocket. Whether you’re learning another language for travel, school, career or your brain health, you’ll love learning with Duolingo. You can learn languages like Spanish, French, German & English while also strengthening your logic, focus, & education through online play and strategic practice. Why Duolingo? • Duolingo is fun and effective. Game-like language lessons and fun character tutors help you build solid speaking, reading, listening & writing skills in Spanish, French, German & more. • Duolingo works. Designed by experts, Duolingo has a science-based teaching methodology proven to foster long-term knowledge retention across language lessons like Spanish, French & German and chess lessons alike. • Track your progress. Work toward your learning goals with playful rewards & achievements as Spanish, French, German & other language lessons become part of your daily habit. • Join millions of learners on Duolingo. Stay motivated as you learn Spanish, French, German & more alongside our global community. • Every Duolingo language course is free. Learn Spanish, French, German, Italian, Russian, Portuguese, Turkish, Dutch, Irish, Danish, Swedish, Ukrainian, Esperanto, Polish, Greek, Hungarian, Norwegian, Hebrew, Welsh, Arabic, Latin, Hawaiian, Scottish Gaelic, Vietnamese, Korean, Japanese, English, & even High Valyrian! What the world is saying about Duolingo ⭐️⭐️⭐️⭐️⭐️: Editor's Choice & \"Best of the Best”- Google Play “Far & away the best language-learning app.”- The Wall Street Journal “This free app & website is among the most effective language-learning methods I’ve tried… lessons come in the form of brief challenges, speaking, translating, answering multiple-choice questions, that keep me coming back for more.”- The New York Times “Duolingo may hold the secret to the future of education.”- TIME Magazine “..Duolingo is cheerful, lighthearted & fun..”- Forbes If you like Duolingo, try Super Duolingo for 14 days free! Learn Spanish, French, German or another language fast with no ads & get fun perks like Unlimited Hearts & Monthly Streak Repair. Send any feedback to android@duolingo.com Use Duolingo on the Web at https://www.duolingo.com Privacy Policy:[https://www.duolingo.com/privacy](< https://www.duolingo.com/privacy>)",
          "image_url": "https://play-lh.googleusercontent.com/tw_coGKgk1K_zO-Ypf9zBKV1s-KT3dYN1MIUxIqtnbfmON5x_YmuoAr31gE4oSfJHNtA-aStTd-qe9R8S6NVyA",
          "developer_name": "Duolingo",
          "rating": 4.7460737,
          "category": "Education",
          "installs": "500,000,000+",
          "content_rating": null,
          "price": null,
          "price_amount": 0,
          "currency": "USD"
        },
        {
          "product_id": "com.picoai.languageapp.android",
          "title": "Language Learning: Pingo AI",
          "url": "https://play.google.com/store/apps/details?id=com.picoai.languageapp.android",
          "description": "Join 8,000,000+ language learners who use Pingo AI to learn languages. Fast, fun, and effective! Pingo AI Language Learning uses results-driven AI for you to learn a language and speak fluently through real-life conversations. No boring drills. No repetitive language lessons. Just real conversations. 🏆Winner of Google Play's Best of 2025 award🏆 💬 Language learning from 25+ languages: Learning languages has never been easier! From beginners to advanced, you will learn to speak languages fluently. Learn to speak Spanish, Korean, Japanese, English, French, German, Chinese (Mandarin), Italian, Portuguese, Russian, Arabic, Dutch, Turkish, Polish, Vietnamese, Hindi, Thai, Hebrew, Greek, Indonesian, Swedish, Norwegian, Danish, Persian (Farsi), and Ukrainian languages. 👋 Speak to Pingo AI as you would a friend Talk about your day, ask questions, and learn languages together. Pingo gives you instant feedback to dramatically improve your language learning skills. Practice speaking from 25+ languages to refine your vocabulary, grammar, and fluency, as well as speak confidently in real conversation exchange for effective language transfer. 🎯 Why use Pingo AI to learn languages ✓ Learn to speak languages fluently through real-life conversations. ✓ Get personalized language lessons. ✓ Learn exactly what to improve, including vocabulary, grammar, relevancy and fluency. ✓ Quickly learn language words and phrases you’ll actually use. ✓ Become fluent and speak confidently in a foreign language. ✓ Proven learning language effectiveness for all levels. ✨ How to use Pingo AI to learn a language: 1) Speak to Pingo! Tell Pingo your language goals. 2) Get a personalized language learning plan to learn languages quickly. 3) Practice speaking in real-life conversations. 4) Pingo remembers your progress and adapts as you improve — your personal language tutor. 5) Receive instant feedback on pronunciation and grammar for every language conversation. 6) Quickly learn to speak languages fluently. 🗣️ Learn a language today! Consistently speaking and conversing in new languages is essential to confidently speak, become fluent, and learn languages. Pingo AI Language Learning transforms self-guided practice into a goal-oriented, interactive learning experience that’s far more effective than simply repeating basic phrases aloud or struggling to find opportunities for real-life language conversation exchange. Pingo AI Language Learning helps you become fluent to learn a language today! ⚡️ Ditch static, repetitive modules and boring lessons. At Pingo AI Language Learning, we’re building the most dynamic and immersive AI language learning experience ever to help you reach your language goals and language transfer as fast as possible. Download one of the leading language learning education apps to learn languages today! 🚀 Learn and speak new languages today! Speak Spanish, Korean, Japanese, English, French, German, Chinese (Mandarin), Italian, Portuguese, Russian, Arabic, Dutch, Turkish, Polish, Vietnamese, Hindi, Thai, Hebrew, Greek, Indonesian, Swedish, Norwegian, Danish, Persian (Farsi), and Ukrainian. Pingo AI Language Learning is your learning language app to fluently speak languages. If you have any ideas or questions, please email us at support@pingo.ai. Subscription Details: Pingo Pro A subscription is required to access full conversation speaking practice and personalized language learning features. Pingo AI Language Learning offers monthly and annual auto-renewing subscriptions. Payment is charged when your purchase is confirmed. Subscriptions renew automatically unless canceled 24 hours before the end of the current billing period. You can manage or cancel your subscription through your Google Play account settings. Terms: https://pingo.ai/terms Privacy Policy: https://pingo.ai/privacy",
          "image_url": "https://play-lh.googleusercontent.com/I0vdd_Q9a1ERwNgn9egMmkzD8R7a4wpTJoq0m-MqaHzDSTGKY_QPIKiXnWk78ajiI5qoRIB8cDT7we7ZYQC9",
          "developer_name": "Pingo AI, Inc.",
          "rating": 4.6573606,
          "category": "Education",
          "installs": "5,000,000+",
          "content_rating": null,
          "price": null,
          "price_amount": 0,
          "currency": "USD"
        },
        {
          "product_id": "com.selabs.speak",
          "title": "Speak: Language Learning",
          "url": "https://play.google.com/store/apps/details?id=com.selabs.speak",
          "description": "Get ready to take your language skills to the next level with Speak, the ultimate language learning app focusing on improving your speaking abilities. Powered by cutting-edge AI technology, Speak ensures that you gain fluency by engaging in real-life conversations and receiving instant feedback. Whether you are learning Spanish, English, French, Italian, Japanese or Korean, Speak's AI-powered lessons will have you learning a new language fast. With Speak, you'll feel like you have a personal language tutor right in your pocket. Our app provides immersive speaking practice sessions that simulate real-life scenarios, allowing you to become confident in your conversational Spanish, English, French, Italian, Japanese and Korean skills. The advanced AI function analyzes your speech, providing valuable assessment on pronunciation, intonation, and fluency. Say goodbye to those language barriers as you receive real-time feedback, enabling you to make necessary adjustments and improve your speaking skills on the spot. Our comprehensive language learning curriculum is available for Spanish, English, French, Italian, Japanese and Korean learners, ensuring that you become fluent. Whether you're a beginner or an advanced learner, Speak caters to your individual needs and helps you progress at your own pace. You'll love the personalized progress tracking, which helps you identify areas that need improvement, allowing you to focus your efforts effectively. Speak's method is simple: STEP 1: Do a real language learning lesson! Learn real-life, essential phrases with your dedicated local teacher. STEP 2: Practice speaking the language! Repeat the learned phrases until you can speak without thinking twice! STEP 3: AI Tutor provides personalized language feedback! With the latest AI technology, you can practice anywhere and anytime! Get real-time feedback on pronunciations, grammar, and much more. STEP 4: Real conversations in your chosen language! Now put what you've learned into real-life situations and speak with confidence! No more boring textbooks or one-sided conversations! With Speak, you'll experience interactive and engaging language practice that feels like a real-life conversation. Break free from traditional language learning and download Speak now! Gain fluency, receive real-time feedback, and become a confident speaker in Spanish, English, French, Italian, Japanese or Korean. There are plenty of other language apps out there, but Speak's key difference comes down to getting you speaking Spanish, English, French, Italian, Japanese or Korean out loud on day 1. SPEAK MEMBERSHIP Speak offers both monthly and annual auto-renewing subscriptions. Become a Speak Member to gain unlimited access to all courses, singles, review material, and other content within Speak. The subscription will automatically renew unless turned off in your Google Play Account settings at least 24 hours before the current period ends. You can go to your Google Play Account settings to manage your subscription and turn off auto-renew. Your Google Play Account will be charged when the purchase is confirmed. If you subscribe before your free trial ends, the rest of your free trial period will be forfeited as soon as your purchase is confirmed. Terms of Service: https://speak.com/tos Privacy Policy: https://speak.com/privacy",
          "image_url": "https://play-lh.googleusercontent.com/B8OICldFwhV66WnijbpJ0a5gvvMxs1yi9RksW2BeR70O2514ihdwge0_75r9bsKsYamBgEQ7R6Lq1wEauX_x4Q",
          "developer_name": "Speakeasy Labs",
          "rating": 4.7485504,
          "category": "Education",
          "installs": "10,000,000+",
          "content_rating": null,
          "price": null,
          "price_amount": 0,
          "currency": "USD"
        }
      ]
    }
  ],
  "top_result": null,
  "pagination": {
    "next_page_token": "pt1.bGl0ZXNjcmFwZTpleUoySWpveExDSnZjR1Z5WVhScGIyNGlPaUpoY0hCeklpd2lZMjl1ZEdWNGRDSTZleUpvYkNJNkltVnVJaXdpWjJ3aU9pSjFjeUlzSW5FaU9pSnNZVzVuZFdGblpTQnNaV0Z5Ym1sdVp5SjlMQ0pyYVc1a0lqb2ljR0ZuWlNJc0luUnZhMlZ1SWpvaVJVRkZZVWxCWjBKRlNXcFpkWE5aUmtkT1ptYzJkSGRPUjFCbE5tZzVTVWRIVFVOMWFUVlpUMGRNWlRCb0xXOUhJbjA"
  }
}
```