Public REST API for app store analytics, rankings, and version tracking. No authentication required.
Base URL: https://techdevnotes.com
All endpoints return JSON. Responses are cached at the CDN edge (Cloudflare) per the TTLs listed below. Rate limit: 60 requests/minute per IP.
Authentication
All API endpoints require an API key. Pass it via header or query parameter:
Authorization: Bearer tdn_your-api-keyGET /api/v1/apps?api_key=tdn_your-api-keyContact us to request an API key.
/api/v1/appscache: 10 minList all active tracked apps with icons and metadata.
/api/v1/apps/{id}cache: 10 minGet a single app’s current rating, review count, latest version, and US rank.
Parameters
idstringrequiredApp Store numeric ID or Google Play package namestorestringapple or google (auto-detected from ID format)/api/v1/apps/{id}/rankingscache: 10 minGet global chart rankings for an app across all tracked countries.
Parameters
idstringrequiredApp IDstorestringapple or googlechart_typestringtop-free, top-paid, or top-grossing (default: top-free)/api/v1/apps/{id}/versionscache: 1 hrGet version release history with release notes.
Parameters
idstringrequiredApp IDstorestringapple or googlelimitnumberMax results (default: 50)/api/v1/apps/{id}/exportExport historical data as CSV or JSON file download.
Parameters
idstringrequiredApp IDstorestringapple or googletypestringrequiredsnapshots, rankings, or versionsformatstringrequiredcsv or jsondaysnumberDays of history (1–730, default: 90)/api/history/{id}cache: 1 hrGet aggregated historical snapshots, rankings, and versions for charting.
Parameters
idstringrequiredApp IDstorestringapple or googledaysstringNumber of days or 'all' (default: 90)countrystringISO country code for ranking history (default: us)/api/comparecache: 1 hrGet comparison data for all tracked apps including time series.
Parameters
storestringapple or google (default: apple)daysnumberDays of history (1–365, default: 90)appsstringComma-separated slugs to filter (max 20)/api/changelogcache: 1 hrGet version releases across all tracked apps.
Parameters
limitnumberMax results (default: 50)offsetnumberPagination offsetstorestringapple or google/api/x-flagscache: 30 minGet the current X.com feature flag manifest.
Parameters
searchstringSearch flags by name/api/x-flags/historycache: 30 minGet X.com feature flag change history.
Parameters
daysnumberDays of history (default: 30)limitnumberMax changes (default: 100)/api/chartscache: 30 minGet live Apple App Store chart rankings.
Parameters
countrystringISO country code (default: us)categorystringiTunes category ID (default: all)typestringtop-free, top-paid, or top-grossinglimitnumberMax results (default: 50)/api/play-chartscache: 30 minGet live Google Play chart rankings.
Parameters
countrystringISO country code (default: us)categorystringPlay Store category (default: APPLICATION)collectionstringTOP_FREE, TOP_PAID, etc.RSS feeds available at /feed.xml (all apps) and /apps/ios/{id}/feed.xml (per app).