VX Agents

API directory · Marketing & Analytics

DataForSEO App Store & Google Play Data

v1.0.0 · 18 endpoints · 0 connections · shared by vx.ai

Where does your app rank for "habit tracker" on Google Play and the App Store, and what are one-star reviewers complaining about? Queue DataForSEO app searches, app detail lookups, review pulls and top-chart lists for both stores, then collect the results when the tasks finish.

Connect this API to an AI agent Browse all specs

What you can do with DataForSEO App Store & Google Play Data via MCP

Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.

MethodPathOperationDescription
GET /v3/app_data/google/locations listGooglePlayLocations List location names and codes for Google Play tasks (free)
GET /v3/app_data/apple/locations listAppStoreLocations List location names and codes for App Store tasks (free)
POST /v3/app_data/google/app_searches/task_post createGooglePlaySearchTask Queue a Google Play search: which apps rank for a keyword
GET /v3/app_data/google/app_searches/task_get/advanced/{id} getGooglePlaySearchResults Get the ranked apps from a Google Play search task
POST /v3/app_data/google/app_info/task_post createGooglePlayAppInfoTask Queue a lookup of a Google Play app's listing details
GET /v3/app_data/google/app_info/task_get/advanced/{id} getGooglePlayAppInfo Get a Google Play app's rating, installs, price and description
POST /v3/app_data/google/app_reviews/task_post createGooglePlayReviewsTask Queue a pull of a Google Play app's reviews
GET /v3/app_data/google/app_reviews/task_get/advanced/{id} getGooglePlayReviews Get the Google Play reviews collected by a task
POST /v3/app_data/google/app_list/task_post createGooglePlayTopChartTask Queue a Google Play top chart (top free, paid, grossing) fetch
GET /v3/app_data/google/app_list/task_get/advanced/{id} getGooglePlayTopChart Get the apps on a Google Play top chart
POST /v3/app_data/apple/app_searches/task_post createAppStoreSearchTask Queue an App Store search: which apps rank for a keyword
GET /v3/app_data/apple/app_searches/task_get/advanced/{id} getAppStoreSearchResults Get the ranked apps from an App Store search task
POST /v3/app_data/apple/app_info/task_post createAppStoreAppInfoTask Queue a lookup of an App Store app's listing details
GET /v3/app_data/apple/app_info/task_get/advanced/{id} getAppStoreAppInfo Get an App Store app's rating, price, version and description
POST /v3/app_data/apple/app_reviews/task_post createAppStoreReviewsTask Queue a pull of an App Store app's reviews
GET /v3/app_data/apple/app_reviews/task_get/advanced/{id} getAppStoreReviews Get the App Store reviews collected by a task
POST /v3/app_data/apple/app_list/task_post createAppStoreTopChartTask Queue an App Store top chart (top free, paid, grossing) fetch
GET /v3/app_data/apple/app_list/task_get/advanced/{id} getAppStoreTopChart Get the apps on an App Store top chart

Authentication

basicAuth

HTTP Basic

DataForSEO uses HTTP basic auth with your API login and API password (not your dashboard password).

How to get a credential

  1. Sign up at https://app.dataforseo.com/register (pay-as-you-go; new accounts get trial credit).
  2. Open API Access in the dashboard (https://app.dataforseo.com/api-access).
  3. Copy the API login (your email) and the API password shown there.

Permissions used

DataForSEO has no scopes: every task is billed from your balance when it is posted.

Access Operations
Billed tasks createGooglePlaySearchTask, createGooglePlayAppInfoTask, createGooglePlayReviewsTask, createGooglePlayTopChartTask, createAppStoreSearchTask, createAppStoreAppInfoTask, createAppStoreReviewsTask, createAppStoreTopChartTask
Results of your own tasks getGooglePlaySearchResults, getGooglePlayAppInfo, getGooglePlayReviews, getGooglePlayTopChart, getAppStoreSearchResults, getAppStoreAppInfo, getAppStoreReviews, getAppStoreTopChart
Free lookups listGooglePlayLocations, listAppStoreLocations

Common errors

DataForSEO answers HTTP 200 and puts the real result in status_code (20000 = ok, 20100 = task created) inside the body and each task.

Code Meaning Fix
401 / 40100 Wrong login or API password Copy both again from API Access.
40200 / 40210 Balance too low Top up the account balance.
40203 Daily cost limit reached Raise the limit under API Settings in the dashboard.
40501 / 40503 Invalid field or location Use location_code from the locations list and a valid app_id.
40601 / 40602 Task handed / still in queue Wait 30-60 seconds and fetch the same id again.
40202 Per-minute rate limit exceeded Slow down and retry.

Store the login and API password as a VX Agents basic-auth credential.

Usage guide

Setup

  • Credential: DataForSEO API login + API password as a basic-auth credential (see the authentication notes).
  • Worth pinning: your market's location_code (e.g. 2840 United States, 2826 United Kingdom) and language_code (en), and your own app ids: the Google Play package name (com.example.app from play.google.com/store/apps/details?id=...) and the numeric App Store id (835599320 from apps.apple.com/.../id835599320).

Track an app's rank and reviews

  1. Look up codes once with listGooglePlayLocations / listAppStoreLocations (free).
  2. Every create...Task body is an array of task objects; send one object per task, e.g. [{"keyword": "habit tracker", "location_code": 2840, "language_code": "en", "depth": 100}].
  3. Keyword ranking: createGooglePlaySearchTask / createAppStoreSearchTask, then getGooglePlaySearchResults / getAppStoreSearchResults with the task id to see which apps rank and where yours is.
  4. Listing details: createGooglePlayAppInfoTask / createAppStoreAppInfoTask with app_id, then getGooglePlayAppInfo / getAppStoreAppInfo (rating, reviews count, installs, price, version, description).
  5. Reviews: createGooglePlayReviewsTask (sort_by newest or most_relevant, rating 1-5 to filter) or createAppStoreReviewsTask (sort_by most_recent or most_helpful), then getGooglePlayReviews / getAppStoreReviews.
  6. Top charts: createGooglePlayTopChartTask (app_collection e.g. topselling_free, topgrossing, optional app_category) or createAppStoreTopChartTask (top_free_ios, top_paid_ios, top_grossing_ios, ...), then the matching get...TopChart.

Good to know

  • Tasks run asynchronously: a get... call right after posting can return 40601/40602 (handed / in queue). Wait 30-60 seconds and fetch again with the same id; results stay available for 30 days.
  • Each posted task costs money (reviews are billed per 150 reviews of depth; keep depth modest). Confirm with the user before posting a batch of tasks or a large depth. priority: 2 costs extra.
  • Check status_code in the body and in each task: 20000 = ok, 20100 = task created.
  • tag lets you label a task (e.g. your app name) and comes back in the results.

Source: DataForSEO App Data API reference (https://docs.dataforseo.com/v3/app_data/overview/), checked 2026-10-24.

How to use this spec

  1. Create a free VX Agents account (sandbox tools included).
  2. Open the marketplace and connect “DataForSEO App Store & Google Play Data” to an agent.
  3. Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.

Related APIs