sonar_ad_spy_ad_analysis
ChatGPTThe cached AI analysis of an ad (hook, angle, format, structure, CTA, why it works) and its video transcript, or analysis: null when it hasn't been analyzed yet — then use sonar_ad_spy_analyze_ad. Free cached read. Requires an Indie or Agency plan (a trial counts).
sonar_ad_spy_ads
ChatGPTA Facebook page's cached Meta ads (Facebook, Instagram, Messenger, Audience Network): stats over every cached ad (active count, longest running, new in 30 days, format and placement mix, max variants), the ads matching the filters with copy, CTA, landing URL, placements, days running and a longevity tier (30d+/60d+/90d+), and daily history of active/new ads (creative velocity). No spend or impression data exists for ads outside the EU — longevity and variants are the signals. Compact by default (no expiring media links; fields: "full" adds them). Media URLs are expiring CDN links; always give users each ad's permanent library_url. refresh_due: true means the copy is over 24h old (sonar_ad_spy_refresh fetches it). Cached read. Requires an Indie or Agency plan (a trial counts).
sonar_ad_spy_analyze_ad
ChatGPTWRITE tool — AI breakdown of why an ad works: hook, persuasion angle, creative format, beat-by-beat structure, CTA and a grounded "why it works" (no invented metrics). Analyses are cached for every Sonar account: an ad that already has one comes back free (cached: true), otherwise the first analysis spends one of the account's daily Ad Spy lookups (a video transcript plus one AI call). Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_competitors
ChatGPTStart here for competitor ads. Every competitor the account tracks, with the Facebook pages (meta_pages) and TikTok accounts (tiktok_accounts) already linked to it and its last page scan, plus today's Ad Spy lookup allowance (used / limit / remaining / resets_at). A competitor with no linked page needs sonar_ad_spy_scan then sonar_ad_spy_link. Cached read. Requires an Indie or Agency plan (a trial counts).
sonar_ad_spy_hide_ads
ChatGPTWRITE tool — remove irrelevant ads from this account's scans ("Remove from scan"), or put them back with hidden: false. Per account only; other accounts still see them. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_link
ChatGPTWRITE tool — confirm which Facebook page or TikTok account belongs to a competitor. Only call it after the user picked the candidate (the mapping is shared by every Sonar account). Accepts only candidates this account's own scans or searches returned in the last 2 days. Spends no lookup; then use sonar_ad_spy_refresh to fetch the ads. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_open_page
ChatGPTWRITE tool — open a Facebook page from a recent search or scan without linking it to a competitor, and return its ads (same shape and filters as sonar_ad_spy_ads). The ads are fetched when the cached copy is over 24h old. Spends one of the account's daily Ad Spy lookups (today's usage comes back in allowance from sonar_ad_spy_competitors); re-opening the same page, account or ad the same day is free. Past the allowance a refresh returns the cached copy with meta.stale and a meta.note to relay. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_refresh
ChatGPTWRITE tool — fetch a page's current Meta ads or a TikTok account's latest videos when the cached copy is over 24h old (a fresher copy comes back unchanged and costs nothing). Linked pages also refresh weekly on their own. Returns the same view as sonar_ad_spy_ads / sonar_ad_spy_tiktok_posts. Spends one of the account's daily Ad Spy lookups (today's usage comes back in allowance from sonar_ad_spy_competitors); re-opening the same page, account or ad the same day is free. Past the allowance a refresh returns the cached copy with meta.stale and a meta.note to relay. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_scan
ChatGPTWRITE tool — search a competitor's Facebook page (channel "meta") or TikTok account (channel "tiktok") and return ranked candidates; an unambiguous top match is flagged best_match. It never links: show the candidates and let the user confirm, then call sonar_ad_spy_link (the page mapping is shared by every Sonar account, so a wrong link misleads everyone). A Meta scan that found nothing in the last 24h replays for free (cooldown: true). Spends one of the account's daily Ad Spy lookups (today's usage comes back in allowance from sonar_ad_spy_competitors); re-opening the same page, account or ad the same day is free. Past the allowance a refresh returns the cached copy with meta.stale and a meta.note to relay. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_script
ChatGPTWRITE tool — adapt a proven competitor ad's FORMAT (not its claims or brand) into an organic TikTok or Reels script the user can film: hook, beats (shot + on-screen text), soft CTA, audio and caption ideas. Every call is a new AI generation and spends one of the account's daily Ad Spy lookups (plus one for the ad's first analysis when it has none yet). Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_search_pages
ChatGPTWRITE tool — free-text search for Facebook advertiser pages by brand or company name, not tied to a tracked competitor. Open a result with sonar_ad_spy_open_page, or link it to a competitor with sonar_ad_spy_link. Spends one of the account's daily Ad Spy lookups (today's usage comes back in allowance from sonar_ad_spy_competitors); re-opening the same page, account or ad the same day is free. Past the allowance a refresh returns the cached copy with meta.stale and a meta.note to relay. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_tiktok_posts
ChatGPTA linked TikTok account's cached public videos with real counters (views, likes, comments, shares, saves), caption, post date and a breakout flag (3× or more the account's median views). Use url (permanent); compact by default, so the expiring cover_url is left out (fields: "full" adds it). Cached read; sonar_ad_spy_refresh with kind "tiktok" fetches newer videos. Requires an Indie or Agency plan (a trial counts).
sonar_ad_spy_unlink
ChatGPTWRITE tool — remove a wrong competitor → Facebook page (advertiser_id) or TikTok account (account_id) link. Pass exactly one. The link is shared, so this also removes it for other Sonar accounts tracking that competitor. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_ad_spy_vault_remove
ChatGPTWRITE tool — delete a saved ad and its stored media files from the vault. Requires an Indie or Agency plan (a trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_add_screenshot
ChatGPTAppend a screen to a screenshot set (at the end; reorder with sonar_update_screenshot_set). Requires an Indie plan (trial counts) and an authorized Sonar account or a write-scope API key.
sonar_alert_events
ChatGPTThe detected alert events for your workspace, newest first — the same feed as the in-app Recent Alerts panel and the email digest: rank drops/gains, top-10 entries/exits, new rankings, rating drops, review spikes, and competitor changes, each with a type-specific payload (app/keyword names, old vs new values). Events only exist for alert types you've enabled rules for (sonar_set_alert); detection runs once daily. Poll with since to react to changes programmatically. Requires an Indie plan (trial counts).
sonar_analyze_competitors
ChatGPTWRITE tool — generates a fresh AI competitive insight for one of your own apps: clusters the keyword gaps vs your competitors into named opportunity themes (with a why-now narrative and per-keyword metrics), writes threat narratives for competitors climbing on your keywords, and diffs against the previous analysis. At most one analysis per app per 7 days (429 with the next available time while in cooldown — use sonar_competitor_landscape to read the current one). Requires a paid (non-trial) Indie plan and an authorized Sonar account or an API key with the write scope.
sonar_app_aso_score
ChatGPTCalculate an ASO (App Store Optimization) audit score (0-100) for an app. Returns the overall score plus an itemized breakdown of checks (title length, keyword usage, screenshots, ratings, etc.) so you can identify what to improve. Works without an API key (free tier, limited daily use per IP).
sonar_app_changes
ChatGPTChange history for a tracked app — detected releases, metadata edits, screenshot swaps, price changes, category moves, iOS product page header swaps (header: data.action added/changed/removed + header artwork) and newly listed iOS In-App Events (in_app_event: title, kind, dates), newest first. Useful for correlating rank movements with what the app (or a competitor) changed. Requires an Indie plan (trial counts).
sonar_app_engagement
ChatGPTApp Store Connect App Analytics for one of your own iOS apps: the impressions → product page views → downloads funnel with conversion rates (page_view_rate, download_rate) and App Store search share, impressions by source (App Store search, browse, app referrer, web referrer…), plus daily installs, deletions and sessions. Impressions follow App Store Connect's definition and INCLUDE product page views, so totals reconcile with ASC. Downloads come from the Sales report. Same numbers as the Engagement page. iOS only. Requires the Agency plan (403 on other plans) AND an App Store Connect connection with an Admin-role key (key_lacks_analytics otherwise); Apple delivers the first analytics 24-48 hours after connecting (pending). Always check status: anything other than ready (not_connected, not_ios, app_not_in_account, pending, key_lacks_analytics) means there's no data and message says how to fix it — never read an empty series as zero. Days Apple hasn't reported yet have reported: false and null metrics.
sonar_app_keywords
ChatGPTList the keywords tracked for an app in the caller's Sonar workspace, with latest difficulty, popularity, results count, note, and starred_at (favorite/target marker) per keyword. Returns the tracked-keyword ids used by sonar_update_keyword_note and sonar_star_keyword, and the keyword_ids used by sonar_keyword_rankings. Cursor-paginated (default 50 per page). Requires an Indie plan (trial counts).
sonar_app_lookup
ChatGPTLook up a single app by its store ID. Returns app metadata including name, developer, category, rating, reviews, installs (Android), and price. Works without an API key (free tier, limited daily use per IP). If the store is throttling, the result may be Sonar's stored copy: it then comes back as { data, meta } with meta.stale: true, its date in meta.stale_as_of, and a meta.note to pass on to the user.
sonar_app_overview
ChatGPTThe dashboard's computed scoreboard for one of your apps in a single call: visibility index and share of voice (with 7-day deltas and a daily spark), ranked / top-10 keyword counts with movement, best rank, the biggest 7-day improvements and drops, the rank-distribution trend, and the actionable opportunity list (near_page_one / top_three_push / easy_target). Use it when asked how an app is doing: these are the same numbers the dashboard renders, already computed from rank history. Requires an Indie plan (trial counts).
sonar_app_rankings
ChatGPTRank history for an app's tracked keywords — daily ranks over the requested window, one history array per keyword. Prefer observations for daily status: ranked has a numeric rank; not_found means a completed search did not return the app (results_count is the returned search size); not_observed means no confirmed check, including legacy gaps. Never interpret an absent rank as a collection failure or assign a numeric rank to it. The legacy history array contains positive ranks only. Use this to check how rankings moved after a metadata change or to find keywords trending up or down. Cursor-paginated over keywords (default 50 per page). Requires an Indie plan (trial counts).
sonar_app_revenue
ChatGPTEstimate monthly revenue for an app, based on install counts, ratings, and category benchmarks. Returns the dollar estimate, a confidence grade (high/medium/low) with the factors behind it, and the methodology used. The figure is a model estimate, not reported revenue; the confidence grade is the part that says how far to trust it. Needs a Sonar API key or connected account (1 credit per call on prepaid API credits); not part of the free tier.
sonar_app_reviews
ChatGPTFetch user reviews for any app, live from the store (up to ~500 of the most recent or most helpful for the country). The star-rating filters and limit apply to that fetched window, so a narrow filter on a small app can return few or no reviews. Useful for sentiment analysis, feature-request mining, and competitive research; for an already-summarized view of a tracked app, sonar_review_insights returns themed AI analysis instead. Needs a Sonar API key or connected account (1 credit per call on prepaid API credits); not part of the free tier. If the store is throttling, the result may be Sonar's stored copy: it then comes back as { data, meta } with meta.stale: true, its date in meta.stale_as_of, and a meta.note to pass on to the user.
sonar_app_sales
ChatGPTApp Store Connect sales for one of your own iOS apps: daily first-time downloads, redownloads, in-app purchase units and approximate USD proceeds (proceeds_usd_approx, converted with a static FX table — present it as approximate), window totals, and a per-country breakdown sorted by downloads. Same numbers as the Performance page. iOS only. Requires the Agency plan (403 on other plans) AND an App Store Connect connection at /settings/connections. Always check status: anything other than ready (not_connected, not_ios, app_not_in_account, pending, key_lacks_analytics) means there's no data and message says how to fix it — never read an empty series as zero. Days Apple hasn't reported yet have reported: false and null metrics.
sonar_app_search
ChatGPTSearch apps in the App Store or Google Play by keyword. Returns ranked list of apps with metadata (results are returned in store ranking order). Works without an API key (free tier, limited daily use per IP). If the store is throttling, the result may be Sonar's stored copy: it then comes back as { data, meta } with meta.stale: true, its date in meta.stale_as_of, and a meta.note to pass on to the user.
sonar_cancel_review_reply
ChatGPTWRITE tool — cancel a scheduled reply (manual or auto mode) before it posts; it goes back to draft. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_competitor_keywords
ChatGPTKeywords a tracked competitor currently ranks for (last 7 days of SERP data), with difficulty and popularity per keyword. Pass own_app_id for gap analysis: keywords where the competitor ranks but your app doesn't are marked gap=missing. Cursor-paginated (default 50 per page). Requires an Indie plan (trial counts).
sonar_competitor_landscape
ChatGPTThe full competitive keyword picture for one of your own apps vs every tracked competitor, in one call: live stats (keyword gaps where competitors rank and you don't, winnable gaps, competitors climbing on your tracked keywords, keywords you lead), the top gap/threat/lead rows with metrics, and the latest AI insight if one was generated (opportunity clusters, threat narratives, strengths, posture). Use it when choosing which keywords to target next. Requires an Indie plan (trial counts).
sonar_create_product
ChatGPTWRITE tool — creates a product in the caller's Sonar workspace and starts tracking the given app(s). A product is the cross-store unit (one iOS + one Android app, or just one of either). Returns the product id and the Sonar app ids needed by sonar_track_keywords and sonar_track_competitor. Own apps count against the plan cap (Indie 10, Agency 50; competitors are not capped) — at the cap the call fails with a 403 plan_limit error. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_create_screenshot_set
ChatGPTCreate an app-store screenshot set for a product, from your own screens layouts or a built-in template. The layout JSON format and template ids are documented by sonar_screenshot_layout_guide. The set is immediately visible/editable for humans in the Screenshot Studio (studio_url in the response). Requires an Indie plan (trial counts) and an authorized Sonar account or a write-scope API key.
sonar_delete_alert
ChatGPTWRITE tool — delete an alert subscription in the caller's Sonar workspace. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_delete_product
ChatGPTWRITE tool — delete a product in the caller's Sonar workspace and untrack every app linked to it, with their tracked keywords, discovered keywords, and competitor links. The product's screenshot sets are deleted too. Shared store data (app metadata, snapshots, rank history) is not deleted. Returns { id, deleted, untracked_apps }. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_delete_screenshot
ChatGPTDelete one screen from a screenshot set. A set keeps at least one screen — deleting the last one is rejected. Requires an Indie plan (trial counts) and an authorized Sonar account or a write-scope API key.
sonar_delete_screenshot_set
ChatGPTPermanently delete a screenshot set and everything in it (screens, translations). Irreversible — confirm with the user before deleting work they may want. Requires an Indie plan (trial counts) and an authorized Sonar account or a write-scope API key.
sonar_delete_tracked_keyword
ChatGPTWRITE tool — stop tracking one keyword/app pair in the caller's Sonar workspace. Identify the pair by its tracked-keyword id (from sonar_app_keywords). Equivalent to sonar_untrack_keywords with a single id; that tool removes several (or all) of an app's keywords in one call. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_discovered_keywords
ChatGPTKeywords Sonar's discovery engine surfaced for one of your tracked apps but that aren't tracked yet — ranked finds (the app already ranks, unnoticed), competitor gaps, and AI/autocomplete-sourced ideas — each with popularity, difficulty, AI relevance, and an opportunity score (0-100, best first). This is Sonar's "what should I track next" answer; rows can be tracked with sonar_track_keywords. Requires an Indie plan (trial counts).
sonar_dismiss_review_reply
ChatGPTWRITE tool — mark a review as not needing a reply (also cancels a scheduled post). Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_draft_review_reply
ChatGPTWRITE tool — write a fresh AI reply draft for a review using the app's instructions (and an optional hint), with English translations. Counts against the monthly AI-draft allowance, then 1 credit per draft. Never posts. Tip: agents can skip this and write the reply themselves with sonar_update_review_reply (not metered). Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_generate_review_insights
ChatGPTWRITE tool — generates a fresh AI review analysis for a tracked app from its recent reviews (praise/complaint themes, sentiment, feature requests, trend vs the previous run). At most one analysis per app+country every 90 days (429 with the next available time while in cooldown — use sonar_review_insights to read the current one); needs at least 5 recent reviews. Requires a paid (non-trial) Indie plan and an authorized Sonar account or an API key with the write scope.
sonar_get_app
ChatGPTGet full details for one tracked app in the caller's Sonar workspace: store metadata plus up to 90 daily snapshots of rating, review count, version, and installs. Requires an Indie plan (trial counts).
sonar_get_screenshot_set
ChatGPTFetch a screenshot set in full: every screen's layout JSON plus per-screen translation overrides keyed by locale. By default inline image data is replaced with placeholders to keep the response readable. Requires an Indie plan (trial counts).
sonar_keyword_metrics
ChatGPTDifficulty + popularity for a specific keyword (or up to 25 in bulk). Use this when you already know which keywords you care about — costs 1 credit per keyword. Works without an API key for up to 5 keywords/day (free tier, per IP); an API key removes that cap. Use sonar_keyword_search instead when you want related keyword ideas alongside metrics. A keyword the API cannot compute right away comes back as pending (queued on the scrape fleet, not charged) — this tool already waits and re-checks briefly; if it is still pending, call again after retry_after_seconds.
sonar_keyword_rankings
ChatGPTSERP history for one tracked keyword — which apps ranked in the top results on each measured day, newest first. Use this to see who competes on a keyword and how the top spots shifted over time. The keyword must be tracked in the caller's Sonar workspace. Requires an Indie plan (trial counts).
sonar_keyword_search
ChatGPTResearch a keyword and related terms. Returns up to 10 rows — the seed keyword plus the store's top autocomplete suggestions — each with difficulty (0-100), popularity score, and results count. Use this to find keywords worth targeting; for metrics on terms you already know, sonar_keyword_metrics is cheaper. On prepaid API credits it costs 10 credits per call (rows that could not be computed are refunded); it needs a Sonar API key or connected account and is not part of the free tier. Answers within about 30 seconds. Each row carries measured_at (difficulty) and popularity_measured_at (popularity, can be older), ISO 8601 UTC; stale: true means at least one of them is older than 7 days. A related term that couldn't be computed in time comes back marked pending (queued, not charged) — get it later with sonar_keyword_metrics.
sonar_keyword_suggestions
ChatGPTGet autocomplete suggestions for a seed keyword from the App Store or Google Play, in the order the store shows them. List position is the only demand signal: the priority field is 0 on Google Play and currently 0 on the App Store as well. Lighter and faster than sonar_keyword_search — use when you only need term ideas without difficulty/popularity scoring. Works without an API key (free tier, limited daily use per IP). If the store is throttling, the result may be Sonar's stored copy: it then comes back as { data, meta } with meta.stale: true, its date in meta.stale_as_of, and a meta.note to pass on to the user.
sonar_list_alerts
ChatGPTList your alert subscriptions — each rule defines a change type (rank drops, review spikes, etc.), its scope (a specific app or org-wide), threshold, and whether it's enabled. Requires an Indie plan (trial counts).
sonar_list_apps
ChatGPTList the apps tracked in the caller's Sonar workspace (own apps + competitors), each with its latest snapshot (rating, review count, version, installs). Returns the Sonar app UUIDs needed by sonar_get_app, sonar_app_keywords, sonar_app_rankings, and sonar_app_changes. Cursor-paginated (default 100 per page). Requires an Indie plan (trial counts).
sonar_list_products
ChatGPTList every product in your workspace (unpaginated): each product's id, name, country, competitor count, and its linked store versions (Sonar app id, store, store_id, name). Product ids are what sonar_track_app, sonar_track_competitor, sonar_remove_competitor, sonar_delete_product, and the screenshot-set tools take; for per-app snapshots and competitor apps use sonar_list_apps. Requires an Indie plan (trial counts).
sonar_list_screenshot_sets
ChatGPTList a product's app-store screenshot sets (metadata only: store, device size, locales, studio_url). Use sonar_get_screenshot_set for full layouts. Requires an Indie plan (trial counts).
sonar_portfolio
ChatGPTThe whole portfolio's health in one call — for orgs managing many apps: per-app KPIs (visibility + 7-day delta, ranked/top-10 counts, net rank movement, rating, review count), org-wide totals, the biggest keyword movers in both directions, a needs-attention triage list (visibility drops, rating drops, not-ranked apps), and the best discovered-keyword opportunities across all apps. Same numbers as the /portfolio page. Requires an Agency plan (403 on other plans).
sonar_remove_competitor
ChatGPTWRITE tool — remove a competitor from a product in the caller's Sonar workspace. Drops the competitor link under every own app of the product; if no other own app in the workspace still references the competitor, the competitor app is untracked as well. 404 when the product has no such competitor. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_review_inbox
ChatGPTAn own iOS app's App Store reviews (synced from App Store Connect every 5 minutes) with their reply state: the AI draft or your text, English translations of non-English reviews and drafts, hold reasons (needs_human, quota, daily_cap), schedule time, and any live App Store response. Newest first, with per-status counts. Use the review id with sonar_update_review_reply / sonar_post_review_reply. Requires an Indie plan (trial counts), App Store Connect connected in Sonar, and the app to be one of your own iOS apps.
sonar_review_insights
ChatGPTThe latest AI review analysis for a tracked app (your own or a competitor): what users praise and complain about as named themes with frequency, verbatim quotes, and trend movement (new / persisting / growing / improving / resolved), plus overall sentiment, surfaced feature requests, and what changed vs the previous analysis. insight is null if none has been generated yet — use sonar_generate_review_insights. Requires an Indie plan (trial counts).
sonar_review_responder
ChatGPTThe review responder's configuration for an own iOS app: whether it is switched on, manual vs auto mode (auto posts AI replies after a delay, only for reviews written after auto was enabled and within the star range), the reply instructions, sign-off, reply language, last sync, plus whether App Store Connect is connected and this month's AI-draft usage (included allowance, then 1 credit per extra draft). settings is null until the responder is switched on. Requires an Indie plan (trial counts), App Store Connect connected in Sonar, and the app to be one of your own iOS apps.
sonar_scan_competitor
ChatGPTWRITE tool — runs an AI keyword discovery scan on a tracked competitor: generates the search terms the competitor's listing is optimized for (brand terms included), queues them for SERP verification, and verifies the first batch inline (~30s), recording both apps' ranks. Returns generated/queued/verified_now counts; the rest verify in the background over the following hours — read results with sonar_competitor_keywords. Each account can scan a limited number of different competitors per UTC day (50 on trial and Indie, 250 on Agency); re-scanning one already scanned today is free, and past the limit the tool reports when it resets. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_screenshot_devices
ChatGPTList the device sizes supported for app-store screenshot sets, with their canvas dimensions (the pixel coordinate space all layouts use) and which store each belongs to — including the landscape App Store creative-asset canvases (category "creative": product page header and search results asset). Pick a device here before sonar_create_screenshot_set. Requires an Indie plan (trial counts).
sonar_screenshot_layout_guide
ChatGPTThe layout-format reference for Sonar screenshot sets: static text, so one call per session is enough. It documents the layout JSON schema, coordinate system, image handling (remote URLs), flowing background shapes, fonts, translation overrides, and the recommended workflow.
sonar_set_alert
ChatGPTWRITE tool — create or update an alert subscription in the caller's Sonar workspace. Upserts on (type + scope): re-submitting the same type/scope updates the existing rule. Omit threshold for the per-type default; omit scope_app_id for an org-wide rule. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_set_screenshot_translations
ChatGPTWrite a locale's translation overrides for screens in a screenshot set (text copy, localized captures/images). Geometry and styling always come from the source layout; anything not overridden falls back to it. The locale is auto-enabled on the set. Requires an Indie plan (trial counts) and an authorized Sonar account or a write-scope API key.
sonar_star_keyword
ChatGPTWRITE tool — stars or unstars a tracked keyword in the caller's Sonar workspace. A star marks the keyword as a favorite/target the user is actively pursuing; starred keywords carry a starred_at timestamp in sonar_app_keywords results. Idempotent: re-starring refreshes the timestamp, unstarring a non-starred keyword is a no-op. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_top_charts
ChatGPTGet a store top chart (free / paid / grossing, overall or by category) with day-over-day movement: per-app rank delta, apps new to the chart, biggest movers and apps that dropped out. Use to see what's rising in a market or category. Note: summary, movers and droppedApps always describe the full top 200 — limit truncates the returned entries only. Movement is empty on the first day a chart is requested (no previous snapshot yet). Answers within about 30 seconds: when a live refresh can't finish in time the newest stored chart is returned with stale: true and its measuredAt date. Works without an API key (free tier, limited daily use per IP).
sonar_track_app
ChatGPTWRITE tool — links the second-store version of an existing Sonar product (e.g. the product already tracks the iOS app and you want to add the Android version, or vice versa). Each product holds at most one iOS + one Android app; to start tracking a brand-new app, use sonar_create_product instead. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_track_competitor
ChatGPTWRITE tool — adds a competitor app under a Sonar product so its keywords and rankings get tracked alongside the product's own app. The product must already have its own app linked in the same store as the competitor. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_track_keywords
ChatGPTWRITE tool — starts daily rank tracking for one or more keywords on an app in the caller's Sonar workspace. Idempotent: re-posting the same terms reports them as already_tracked instead of creating duplicates. Returns per-keyword outcomes (created / already_tracked / failed). Tracked keywords count against the workspace's plan cap (Indie 2,500, Agency 10,000 per workspace); terms beyond the remaining headroom come back as failed with the plan-limit message while the rest are still tracked. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_untrack_app
ChatGPTWRITE tool — untrack an app in the caller's Sonar workspace. Deletes the workspace's tracked keywords for it (with their notes and stars), its discovered keywords, and its competitor links, and detaches it from its product — deleting the product, and that product's screenshot sets, if no other app is left. Shared store data (app metadata, snapshots, rank history) is not deleted. To drop a competitor from one product use sonar_remove_competitor instead. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_untrack_keywords
ChatGPTWRITE tool — bulk-untrack keywords for an app in the caller's Sonar workspace. Pass all: true to remove every tracked keyword, OR ids: [...] to remove specific ones (exactly one of the two). For a single keyword, sonar_delete_tracked_keyword is equivalent. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_update_keyword_note
ChatGPTWRITE tool — sets or clears the note on a tracked keyword in the caller's Sonar workspace (e.g. why it's tracked, an optimization hypothesis, a reminder). Idempotent: re-sending the same note is a no-op. Requires an Indie plan (trial counts) and an authorized Sonar account or an API key with the write scope.
sonar_update_screenshot
ChatGPTReplace one screen's layout in a screenshot set. Whole-document replace — fetch the current layout, modify it, send it back. The change shows up immediately in the Screenshot Studio for human review. Requires an Indie plan (trial counts) and an authorized Sonar account or a write-scope API key.
sonar_update_screenshot_set
ChatGPTRename a screenshot set, replace its extra-locale list, and/or reorder its screens. Returns the updated set (with image data stripped). Requires an authorized Sonar account or a write-scope API key.
sonar_add_screenshot
Claudesonar_alert_events
Claudesonar_analyze_competitors
Claudesonar_app_aso_score
Claudesonar_app_changes
Claudesonar_app_keywords
Claudesonar_app_lookup
Claudesonar_app_overview
Claudesonar_app_rankings
Claudesonar_app_revenue
Claudesonar_app_reviews
Claudesonar_app_search
Claudesonar_competitor_keywords
Claudesonar_competitor_landscape
Claudesonar_create_product
Claudesonar_create_screenshot_set
Claudesonar_delete_alert
Claudesonar_delete_product
Claudesonar_delete_screenshot
Claudesonar_delete_screenshot_set
Claudesonar_delete_tracked_keyword
Claudesonar_discovered_keywords
Claudesonar_generate_review_insights
Claudesonar_get_app
Claudesonar_get_screenshot_set
Claudesonar_keyword_metrics
Claudesonar_keyword_rankings
Claudesonar_keyword_search
Claudesonar_keyword_suggestions
Claudesonar_list_alerts
Claudesonar_list_apps
Claudesonar_list_products
Claudesonar_list_screenshot_sets
Claudesonar_portfolio
Claudesonar_remove_competitor
Claudesonar_review_insights
Claudesonar_scan_competitor
Claudesonar_screenshot_devices
Claudesonar_screenshot_layout_guide
Claudesonar_set_alert
Claudesonar_set_screenshot_translations
Claudesonar_star_keyword
Claudesonar_top_charts
Claudesonar_track_app
Claudesonar_track_competitor
Claudesonar_track_keywords
Claudesonar_untrack_app
Claudesonar_untrack_keywords
Claudesonar_update_keyword_note
Claudesonar_update_screenshot
Claudesonar_update_screenshot_set
Claude