mcp

Search App Store and Google Play apps across 25+ filters — store, category, language (including not_languages, a localization-gap filter that finds apps NOT localized in a given language), price model, rating, review count, download and revenue estimates (min and max), release and update recency, and review-growth direction — sorted by any column. The tool behind niche sizing, competitor shortlists, and localization-gap hunting. Cost: 1 credit.

{
  "type": "object",
  "properties": {
    "store": {
      "anyOf": [
        {
          "enum": [
            "apple",
            "google"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Limit results to one store: 'apple' (App Store) or 'google' (Google Play). Omit to search both.",
      "title": "Store"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Store category name to filter by, e.g. 'Health & Fitness', 'Productivity', 'Games'. Use 'categories' to include several at once.",
      "title": "Category"
    },
    "categories": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Several category names to include, e.g. ['Health & Fitness', 'Lifestyle']. Takes precedence over 'category'.",
      "title": "Categories"
    },
    "search": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Free-text query matched against app title and developer name, e.g. 'calorie tracker'.",
      "title": "Search"
    },
    "search_in": {
      "anyOf": [
        {
          "enum": [
            "all",
            "title",
            "developer"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Which field 'search' matches: 'title', 'developer', or 'all' (default). Use 'developer' to list a publisher's portfolio.",
      "title": "Search In"
    },
    "language": {
      "anyOf": [
        {
          "maxLength": 5,
          "minLength": 2,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Single app-language code the listing supports, e.g. 'en', 'de', 'pt-BR'.",
      "title": "Language"
    },
    "languages": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Several app-language codes to include, e.g. ['en', 'es'].",
      "title": "Languages"
    },
    "not_languages": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Localization-gap filter: return only apps NOT localized in any of these language codes, e.g. ['it'] finds apps without an Italian localization. App Store data only — combine with languages=['en'] to shortlist English apps missing a target market's language.",
      "title": "Not Languages"
    },
    "price_model": {
      "anyOf": [
        {
          "enum": [
            "Free",
            "Freemium",
            "Paid"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Monetisation model: 'Free', 'Freemium' or 'Paid'. Case-insensitive on input.",
      "title": "Price Model"
    },
    "min_rating": {
      "anyOf": [
        {
          "maximum": 5,
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lowest average star rating to include, 0-5, e.g. 4.",
      "title": "Min Rating"
    },
    "max_rating": {
      "anyOf": [
        {
          "maximum": 5,
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highest average star rating to include, 0-5; use to find weak incumbents.",
      "title": "Max Rating"
    },
    "min_reviews": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lowest lifetime review count, e.g. 1000.",
      "title": "Min Reviews"
    },
    "max_reviews": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highest lifetime review count, e.g. 1000 to exclude entrenched giants.",
      "title": "Max Reviews"
    },
    "min_downloads": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lowest estimated monthly downloads, e.g. 10000.",
      "title": "Min Downloads"
    },
    "max_downloads": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highest estimated monthly downloads.",
      "title": "Max Downloads"
    },
    "min_revenue": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lowest estimated monthly revenue in USD, e.g. 10000 for $10K/month.",
      "title": "Min Revenue"
    },
    "max_revenue": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highest estimated monthly revenue in USD, e.g. 50000 for $50K/month.",
      "title": "Max Revenue"
    },
    "max_days_since_release": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Only apps first released within this many days, e.g. 90 for fresh launches.",
      "title": "Max Days Since Release"
    },
    "max_days_since_update": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Only apps updated within this many days, e.g. 30 for actively maintained apps.",
      "title": "Max Days Since Update"
    },
    "released_after": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Only apps released on or after this date, 'YYYY-MM-DD'.",
      "title": "Released After"
    },
    "released_before": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Only apps released on or before this date, 'YYYY-MM-DD'.",
      "title": "Released Before"
    },
    "updated_after": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Only apps last updated on or after this date, 'YYYY-MM-DD'.",
      "title": "Updated After"
    },
    "updated_before": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Only apps last updated on or before this date, 'YYYY-MM-DD'.",
      "title": "Updated Before"
    },
    "growth_metric": {
      "anyOf": [
        {
          "const": "reviews",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Metric the growth filter measures — currently only 'reviews'.",
      "title": "Growth Metric"
    },
    "growth_period": {
      "anyOf": [
        {
          "enum": [
            "7d",
            "14d",
            "30d",
            "60d",
            "90d"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Window growth is measured over: '7d', '14d', '30d', '60d' or '90d'. Only '7d' covers Google Play; the longer windows are App Store data, so combining them with store='google' is rejected and leaving the store unset ranks App Store apps only.",
      "title": "Growth Period"
    },
    "growth_direction": {
      "anyOf": [
        {
          "enum": [
            "up",
            "down"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Keep only apps growing ('up') or declining ('down') over 'growth_period'.",
      "title": "Growth Direction"
    },
    "min_growth_pct": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lowest absolute growth percentage over 'growth_period', e.g. 20 for at least ±20%.",
      "title": "Min Growth Pct"
    },
    "sort_by": {
      "$ref": "#/$defs/AppSortBy",
      "default": "downloads",
      "description": "Column to sort by: 'downloads' (default), 'revenue', 'growth', 'reviews', 'rating', 'title', 'released' or 'updated'."
    },
    "sort_dir": {
      "$ref": "#/$defs/SortDirection",
      "default": "desc",
      "description": "Sort direction: 'desc' (default, highest first) or 'asc'."
    },
    "limit": {
      "default": 10,
      "description": "How many apps to return, 1-50 (default 10).",
      "maximum": 50,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "How many apps to skip before returning results; use for paging.",
      "minimum": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "$defs": {
    "AppSortBy": {
      "enum": [
        "downloads",
        "revenue",
        "growth",
        "reviews",
        "rating",
        "title",
        "released",
        "updated"
      ],
      "title": "AppSortBy",
      "type": "string"
    },
    "SortDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "title": "SortDirection",
      "type": "string"
    }
  },
  "description": "Explore-grade app search. Every filter is optional; supplied ones combine (AND)."
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "Name of the tool that produced this result."
    },
    "credits_charged": {
      "type": "integer",
      "description": "API credits debited from the account balance for this call."
    },
    "data": {
      "type": "object",
      "description": "One page of matching apps. Each item carries app_id, title, developer, category, rating, review count, monthly download and revenue estimates, and recent review-growth percentages.",
      "properties": {
        "items": {
          "type": "array",
          "description": "Matching rows for this page."
        },
        "total": {
          "type": "integer",
          "description": "Total rows matching the query."
        },
        "limit": {
          "type": "integer",
          "description": "Page size that was applied."
        },
        "offset": {
          "type": "integer",
          "description": "Row offset that was applied."
        }
      }
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}

Return one app's full record. Accepts the canonical id ("apple:284882215", "google:com.spotify.music"), a bare Apple track id, an Android package name, or a pasted App Store / Google Play URL. Cost: 1 credit.

{
  "type": "object",
  "properties": {
    "app_id": {
      "description": "The app to look up. Accepts the canonical '<store>:<store_id>' form ('apple:284882215', 'google:com.spotify.music'), a bare Apple track id ('284882215'), an Android package name ('com.spotify.music'), or a full App Store / Google Play URL.",
      "title": "App Id",
      "type": "string"
    }
  },
  "required": [
    "app_id"
  ]
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "Name of the tool that produced this result."
    },
    "credits_charged": {
      "type": "integer",
      "description": "API credits debited from the account balance for this call."
    },
    "data": {
      "type": "object",
      "description": "The app's full record: title, developer, category, price, rating and review counts, download and revenue estimates, store description, icon and screenshot URLs, release and last-update dates, and developer_url — the developer's own website when the App Store lists one (Apple only; null for Google Play and for apps without a site)."
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}

Return historical metric points for one app (daily up to 90 days, weekly beyond). Cost: 1 credit.

{
  "type": "object",
  "properties": {
    "store": {
      "default": "apple",
      "description": "Which store the store_id belongs to: 'apple' or 'google'.",
      "enum": [
        "apple",
        "google"
      ],
      "title": "Store",
      "type": "string"
    },
    "store_id": {
      "description": "Store-native app id without the store prefix: numeric track id for Apple ('284882215'), bundle id for Google ('com.spotify.music').",
      "maxLength": 80,
      "minLength": 1,
      "title": "Store Id",
      "type": "string"
    },
    "days": {
      "default": 30,
      "description": "Length of the history window in days, 7-730 (default 30). Points are daily up to 90 days and weekly beyond that.",
      "maximum": 730,
      "minimum": 7,
      "title": "Days",
      "type": "integer"
    }
  },
  "required": [
    "store_id"
  ]
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "Name of the tool that produced this result."
    },
    "credits_charged": {
      "type": "integer",
      "description": "API credits debited from the account balance for this call."
    },
    "data": {
      "type": "object",
      "description": "Time series for the requested window. Each item is one dated point with rating, rating_count, reviews_delta_7d, downloads_est_monthly, revenue_est_monthly and growth_reviews_7d_pct.",
      "properties": {
        "items": {
          "type": "array",
          "description": "Dated metric points, oldest first."
        }
      }
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}

Score one keyword for difficulty and opportunity, on the App Store or Google Play. Cost: 10 credits.

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "Search term to score as an ASO target, e.g. 'habit tracker'.",
      "maxLength": 80,
      "minLength": 2,
      "title": "Keyword",
      "type": "string"
    },
    "store": {
      "default": "apple",
      "description": "Store to score against: 'apple' or 'google'.",
      "enum": [
        "apple",
        "google"
      ],
      "title": "Store",
      "type": "string"
    },
    "country": {
      "default": "US",
      "description": "Two-letter ISO country code of the storefront, e.g. 'US', 'DE' (default 'US').",
      "maxLength": 2,
      "minLength": 2,
      "title": "Country",
      "type": "string"
    },
    "language": {
      "default": "en",
      "description": "Language code the keyword is written in, e.g. 'en', 'de', 'pt-BR' (default 'en').",
      "maxLength": 5,
      "minLength": 2,
      "title": "Language",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ]
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "Name of the tool that produced this result."
    },
    "credits_charged": {
      "type": "integer",
      "description": "API credits debited from the account balance for this call."
    },
    "data": {
      "type": "object",
      "description": "Scores for the keyword in the requested storefront: difficulty and popularity (0-100), traffic_score and opportunity_score, echoed back with the keyword, store, country and language.",
      "properties": {
        "keyword": {
          "type": "string",
          "description": "The keyword that was scored."
        },
        "difficulty": {
          "type": "integer",
          "description": "How hard it is to rank, 0 (easy) to 100 (hard)."
        },
        "popularity": {
          "type": "integer",
          "description": "Estimated search demand, 0 (none) to 100 (highest)."
        },
        "traffic_score": {
          "type": "integer",
          "description": "Expected traffic if the app ranks well, 0-100."
        },
        "opportunity_score": {
          "type": "integer",
          "description": "Combined demand-vs-competition attractiveness, 0-100."
        }
      }
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}

Score up to 10 keywords in one call. Cost: 10 credits per keyword.

{
  "type": "object",
  "properties": {
    "keywords": {
      "description": "Up to 10 search terms to score in one call, e.g. ['habit tracker', 'daily planner'].",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "title": "Keywords",
      "type": "array"
    },
    "store": {
      "default": "apple",
      "description": "Store to score against: 'apple' or 'google'.",
      "enum": [
        "apple",
        "google"
      ],
      "title": "Store",
      "type": "string"
    },
    "country": {
      "default": "US",
      "description": "Two-letter ISO country code of the storefront, e.g. 'US', 'DE' (default 'US').",
      "maxLength": 2,
      "minLength": 2,
      "title": "Country",
      "type": "string"
    },
    "language": {
      "default": "en",
      "description": "Language code the keywords are written in, e.g. 'en', 'de' (default 'en').",
      "maxLength": 5,
      "minLength": 2,
      "title": "Language",
      "type": "string"
    }
  },
  "required": [
    "keywords"
  ]
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "Name of the tool that produced this result."
    },
    "credits_charged": {
      "type": "integer",
      "description": "API credits debited from the account balance for this call."
    },
    "data": {
      "type": "object",
      "description": "One score row per submitted keyword, each shaped like the get_keyword_difficulty result.",
      "properties": {
        "items": {
          "type": "array",
          "description": "Score rows, one per keyword."
        },
        "total": {
          "type": "integer",
          "description": "How many keywords were scored."
        }
      }
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}

Read app reviews two ways: pass app_id for live store reviews of ANY app — App Store or Google Play — (no tracking needed, storefront selectable), or omit it to read the workspace's tracked apps with sentiment, topics and improvement areas attached. Live Google Play rows carry no title (Play reviews have none). Cost: 1 credit.

{
  "type": "object",
  "properties": {
    "app_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Any app to read reviews for, whether or not the workspace tracks it. Accepts 'apple:284882215', 'google:com.duolingo', a bare Apple track id, an Android package name, or a store URL. Reviews come straight from the store and carry no sentiment/topic enrichment; Google Play rows have no title.",
      "title": "App Id"
    },
    "country": {
      "default": "US",
      "description": "Two-letter storefront code the reviews are read from, e.g. 'US', 'DE' (default 'US'). Only applies when 'app_id' is used. For Google Play this also picks the review language of that storefront.",
      "maxLength": 2,
      "minLength": 2,
      "title": "Country",
      "type": "string"
    },
    "tracked_app_id": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "UUID of one tracked app in the caller's workspace. Omit to read reviews across all tracked apps.",
      "title": "Tracked App Id"
    },
    "store": {
      "anyOf": [
        {
          "enum": [
            "apple",
            "google"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to reviews from one store: 'apple' or 'google'.",
      "title": "Store"
    },
    "store_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to one app by its store-native id, e.g. '284882215' or 'com.spotify.music'.",
      "title": "Store Id"
    },
    "sentiment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by review sentiment: 'positive', 'neutral' or 'negative'.",
      "title": "Sentiment"
    },
    "topic": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by an extracted topic label, e.g. 'pricing', 'onboarding', 'bugs'.",
      "title": "Topic"
    },
    "limit": {
      "default": 10,
      "description": "How many reviews to return, 1-50 (default 10).",
      "maximum": 50,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "How many reviews to skip before returning results. Live store reads ('app_id' set) reach the 200 newest reviews per app and storefront, so page until 'has_more' is false rather than to a fixed depth; workspace reads page the full stored history.",
      "minimum": 0,
      "title": "Offset",
      "type": "integer"
    }
  }
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "Name of the tool that produced this result."
    },
    "credits_charged": {
      "type": "integer",
      "description": "API credits debited from the account balance for this call."
    },
    "data": {
      "type": "object",
      "description": "One page of reviews. Every item carries title, body, star rating, author, version, country and publish date. Workspace rows add the enrichment layer (sentiment, topics, improvement areas); live store rows do not. The result's 'source' field is 'workspace' or 'store_feed' and 'enriched' says which.",
      "properties": {
        "items": {
          "type": "array",
          "description": "Review rows for this page."
        },
        "source": {
          "type": "string",
          "description": "'workspace' for tracked, enriched reviews; 'store_feed' for live store reviews."
        },
        "enriched": {
          "type": "boolean",
          "description": "True when sentiment/topics/improvement areas are present."
        }
      }
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}

Return supported country codes. Cost: free.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "Name of the tool that produced this result."
    },
    "credits_charged": {
      "type": "integer",
      "description": "API credits debited from the account balance for this call."
    },
    "data": {
      "type": "object",
      "description": "Storefronts this server can score keywords for. Each item has a two-letter code and the country name.",
      "properties": {
        "items": {
          "type": "array",
          "description": "Supported storefronts."
        },
        "total": {
          "type": "integer",
          "description": "How many storefronts are supported."
        }
      }
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}