mcp

Search App Store and Google Play apps across 25+ filters — store, category, games and game genres (named alike on both stores), 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 per row returned (an empty page costs 1).

{
  "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"
    },
    "games": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "true: games only, on both stores — the App Store 'Games' category and every Google Play game category. Narrow with 'game_genres'.",
      "title": "Games"
    },
    "game_genres": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Games of these genres, named alike on both stores, e.g. ['Puzzle', 'Role Playing', 'Strategy'] (also Action, Adventure, Arcade, Board, Card, Casino, Casual, Educational, Family, Music, Racing, Simulation, Sports, Trivia, Word). Implies 'games'.",
      "title": "Game Genres"
    },
    "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', for both stores. Google Play apps are measured every few weeks, so their 14-90 day growth is pro-rated from each app's nearest earlier measurement and covers far more Play apps than '7d' does.",
      "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": {
      "enum": [
        "downloads",
        "revenue",
        "growth",
        "reviews",
        "rating",
        "title",
        "released",
        "updated"
      ],
      "type": "string",
      "default": "downloads",
      "description": "Column to sort by: 'downloads' (default), 'revenue', 'growth', 'reviews', 'rating', 'title', 'released' or 'updated'."
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort direction: 'desc' (default, highest first) or 'asc'."
    },
    "limit": {
      "description": "How many apps to return, 1-100. If omitted: 20 for assistant sign-in connections, 50 with an API key. Each returned app costs 1 credit, so ask for the page size you need; when the balance is lower, the page shrinks to the balance.",
      "maximum": 100,
      "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"
    }
  },
  "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. revenue_capped=true marks an App Store revenue estimate that is an upper bound: the app is not in its category's US top-grossing chart, so it earns less than the bottom of that chart. revenue_est_text gives each estimate as it should be quoted, e.g. \"up to $10,993/mo (below the top-grossing chart)\".",
      "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 (the requested limit, capped at the balance)."
        },
        "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). revenue_capped=true marks an App Store revenue estimate that is an upper bound: the app is not in its category's US top-grossing chart, so it earns less than the bottom of that chart. revenue_est_text gives each estimate as it should be quoted, e.g. \"up to $10,993/mo (below the top-grossing chart)\"."
    }
  },
  "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. revenue_capped=true marks an App Store revenue estimate that is an upper bound: the app is not in its category's US top-grossing chart, so it earns less than the bottom of that chart. revenue_est_text gives each estimate as it should be quoted, e.g. \"up to $10,993/mo (below the top-grossing chart)\".",
      "properties": {
        "items": {
          "type": "array",
          "description": "Dated metric points, oldest first."
        }
      }
    }
  },
  "required": [
    "tool",
    "credits_charged",
    "data"
  ]
}

Return one app's listing change history, newest first: new versions, icon and screenshot redesigns (visually verified), price and business-model changes, renames, category moves, description rewrites and more, grouped by day. 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": 20,
      "description": "How many change days to return, newest first, 1-60 (default 20). A change day groups every field that changed on that date.",
      "maximum": 60,
      "minimum": 1,
      "title": "Days",
      "type": "integer"
    },
    "before": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Return only days strictly before this date (YYYY-MM-DD). Pass the previous response's next_before to page back through the history.",
      "title": "Before"
    }
  },
  "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": "Change days, newest first. Each day lists the fields that changed with their old and new values (list fields such as screenshot_urls also as arrays), plus per-field counts over the app's whole history and a cursor for older days.",
      "properties": {
        "days": {
          "type": "array",
          "description": "Change days, newest first: {date, changes: [{field, old_value, new_value, old_items, new_items, prev_seen}]}."
        },
        "counts": {
          "type": "object",
          "description": "Changes per field over all history."
        },
        "has_more": {
          "type": "boolean",
          "description": "Whether older change days exist."
        },
        "next_before": {
          "type": [
            "string",
            "null"
          ],
          "description": "Pass as `before` to fetch the next, older page (YYYY-MM-DD)."
        }
      }
    }
  },
  "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 per row returned (an empty page costs 1).

{
  "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": {
      "description": "How many reviews to return, 1-100. If omitted: 20 for assistant sign-in connections, 50 with an API key. Each returned review costs 1 credit, so ask for the page size you need.",
      "maximum": 100,
      "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"
  ]
}