Garmin Connect IQ Scraper

Scrape the Garmin Connect IQ Store — watch faces, apps, widgets, data fields and audio for Garmin devices. Search by keyword, browse by category or compatible device, fetch by URL, and get full app details: developer, download counts, ratings, review counts, prices, screenshots, supported devices, permissions and changelogs. HTTP-only via the public Connect IQ Store JSON API. No auth, no proxy required.

Transport note: Garmin's API fingerprint-throttles plain httpx/requests clients (blanket 400 responses after a few requests). This actor uses curl_cffi with Chrome impersonation, which is not throttled. The API also rejects pageSize > 30 and requires string app-type codes (watchface, watch-app, widget, datafield, audio-content-provider-app) — both verified and encoded in the actor.

What this actor does

• Four modes: search, browseByCategory, browseByDevice, byUrl
• 5 categories: watch faces, apps, widgets, data fields, audio
• 61 curated devices (fēnix, Forerunner, Venu, vívoactive, Instinct, Edge, …)
• Filters: min rating, contains-keyword, sort order, country
• Optional reviews: emit per-app review records
• Empty fields are omitted

Data Source

The Garmin Connect IQ Store (apps.garmin.com) — watch faces, apps, widgets, data fields and audio for Garmin devices. The actor reads the public Connect IQ Store JSON API (apps.garmin.com/api/appsLibraryExternalServices/api/asw) that powers the store website. No login, no cookies, no proxy required.

Output per app

• appId, name, description, whatsNew
• developer, developerId, trustedDeveloper
• category, typeId — watch face / app / widget / data field / audio
• rating, reviewCount, downloadCount
• price, salePrice, currency, priceFormatted
• version, updatedAt, releasedAt, status
• iconUrl, heroImageUrl, screenshots[] — store CDN media
• permissions[], compatibleDevicePartNumbers[], supportedDevices[] — human-readable device names
• requiresExternalSubscription, hasTrialMode
• supportEmail, websiteUrl, privacyPolicyUrl, videoUrl
• sourceUrl — canonical Connect IQ Store app page
• recordType: "app", scrapedAt

Output per review (when includeReviews is on)

• reviewId, appId, rating, upvotes, content
• reviewerName, reviewedAt, appVersion
• sourceUrl, recordType: "review", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / browseByCategory / browseByDevice / byUrl
searchQuery	string	running	Free-text keyword (mode=search)
category	enum	all	5 categories (mode=browseByCategory)
device	enum	–	61 curated devices (mode=browseByDevice)
appUrls	array	–	App URLs or UUIDs (mode=byUrl)
minRating	number	–	Min rating (1–5)
containsKeyword	string	–	Substring filter on name/description/developer
sortType	enum	trending	trending / mostPopular / hotFresh
countryCode	enum	US	Store country (24 options)
includeCompatibleDevices	bool	true	Resolve device names for compatible devices
includeReviews	bool	false	Emit review records
reviewsPerApp	int	10	Review cap per app
maxItems	int	50	Hard cap (1–1000)

Example: search watch faces

{
  "mode": "search",
  "searchQuery": "running",
  "category": "watchFaces",
  "minRating": 4.5,
  "maxItems": 30
}

Example: browse a category

{
  "mode": "browseByCategory",
  "category": "dataFields",
  "sortType": "mostPopular",
  "maxItems": 100
}

Example: browse apps for a device

{
  "mode": "browseByDevice",
  "device": "fenix8pro",
  "category": "watchFaces",
  "minRating": 4,
  "maxItems": 50
}

Example: fetch by URL with reviews

{
  "mode": "byUrl",
  "appUrls": [
    "https://apps.garmin.com/en-US/apps/e55067c1-0bc4-4ca8-96bc-bed2c83f5498"
  ],
  "includeReviews": true,
  "reviewsPerApp": 15
}

Limitations

• API fingerprint-throttles plain HTTP clients — Garmin's API answers blanket 400 responses to plain httpx/requests after a few requests; this actor uses curl_cffi with Chrome impersonation, which is not throttled.
• API page cap — the API rejects pageSize > 30, so pagination steps are limited to 30 apps per request.
• downloadCount is banded — Garmin reports approximate download counts in bands (10,000 / 100,000 / 500,000), not exact figures.
• Free apps have no price — apps without a pricing block omit the price fields entirely; salePrice appears only during a sale.
• supportedDevices is best-effort — device names are resolved through the store's device catalog; when the catalog lookup fails, only compatibleDevicePartNumbers is emitted.
• Reviews are opt-in and capped — includeReviews emits review records, capped at reviewsPerApp (default 10) per app and maxItems overall.

Use cases

• Watch-face market research — pricing, ratings and download benchmarks per category
• Device compatibility feeds — map every app to the Garmin devices it supports
• Competitive intelligence — track developer activity, releases and changelogs
• App-store monitoring — daily snapshots of ratings, review counts and prices
• Review analytics — feedback mining per watch face or app
• Content enrichment — screenshots and descriptions for wearable content directories

FAQ

What is the data source? The public Connect IQ Store API (apps.garmin.com/api/appsLibraryExternalServices/api/asw) that powers the store website. No login, cookies or proxy are required.

Are there rate limits? None documented for normal scraping. The actor paces requests politely and retries on 429/5xx with backoff. A proxy is used automatically only if direct access gets blocked.

What do the record types mean? app records are full app-store entries. review records (opt-in) are individual user reviews with ratings and text.

Why are some apps missing a price? Free apps have no pricing block — the fields are simply omitted. Paid apps always include price, currency and priceFormatted; salePrice appears only when a sale is active.

What is downloadCount? Garmin reports approximate download counts in bands (10,000 / 100,000 / 500,000). Treat it as an order-of-magnitude metric.

Why do compatibleDevicePartNumbers and supportedDevices both appear? The part numbers are the raw values from the API; supportedDevices resolves them to human-readable device names (fēnix 7 Pro, Forerunner 965, …) via the store's device catalog.

How fresh is the data? Live — every run queries the Connect IQ Store API in real time, including prices, ratings and versions.

Is this affiliated with Garmin? No — this is a third-party actor using the public Connect IQ Store API and website.