Skip to content
Tech Dev NotesTech Dev Notes
AppsApp designNotes
/
Try asking
?Top climbers on the App Store this weekAsk
?Where does ChatGPT rank?Ask
?Which apps use RevenueCat?Ask
?Highest rated apps on Google PlayAsk
?Largest iOS appsAsk
?Most used SDKs on AndroidAsk

Apps
  • App directory
  • Find any app
  • Developers
  • Compare apps
Charts
  • App Store charts
  • Google Play charts
  • Tracked apps
Screens and icons
  • In-app screens
  • Store screenshots
  • App icons
Tech stacks
  • Tech stacks by app
  • Technologies
Notes
  • Blog
Labs
  • X feature flags
  • Grok companions
  • Grokipedia

Tech Dev Notes © 2026

RSSAboutAPIDevelopersFind any appStatusSecurityPrivacyTermsSite map@techdevnotes

Developers

Public API for tracked apps.

JSON under /api/v1 with a personal API key. Shapes below match the shipped route handlers.

27 v1 endpoints·60-300 requests / min per key·Every data endpoint needs a key·Create a key in Account

Auth

API keys

Create a key on your account page. The raw tdn_ value is shown once. After that, Account and Console show only a short prefix (the first 12 characters). The server stores a SHA-256 hash and looks keys up by that hash. Send the raw key as Authorization: Bearer tdn_… (query keys are not accepted). New account keys are free tier and require a signed-in user. Invalid or revoked keys return 401; more than 20 failed key attempts per IP per minute return 429. Over limit returns 429 with Retry-After. Every data endpoint needs a key, including requests that look like they come from this site. Browser headers such as Referer, Origin and Sec-Fetch-Site are never accepted in place of a key.

Manage keys at /account. Do not commit keys. Rotate by revoking in Account and creating a new key.

MCP

Streamable HTTP at /api/mcp

MCP clients connect to https://techdevnotes.com/api/mcp with the same tdn_ key used for /api/v1. Every request must send Authorization: Bearer tdn_... or the route returns 401 (same-origin requests are not exempt). Bodies over 256 KB and JSON-RPC batches over 10 messages return 413. Server name and title are techdevnotes. Tracked-app tools: list_apps, get_app, get_app_rankings, get_app_versions, get_app_screenshots, get_app_icons, export_app, compare_apps. Site intel tools: search_screenshots, get_tech_stack, get_x_flags, get_rank_movers, get_charts. Aliases: get_version_history, get_rankings, get_screenshots, search_screens, get_icons. Added tools: search_apps, get_store_listing, sdk_adoption, get_design_tokens, get_design_brief. Site data tools: list_notes, get_note, get_leaderboard, get_rank_history, get_store_screenshots, search_site. They take the same bounds as the matching v1 endpoints. Every read tool sets readOnlyHint. Results include structuredContent, a short text summary and image URLs rather than inline bytes. A browser Origin must be this site, www, console.techdevnotes.com, or localhost. A missing Origin is allowed. An invalid Origin returns 403. Tool calls are metered under the canonical tool name. Responses never live-scrape stores.

Discovery

OpenAPI, llms.txt and MCP

The OpenAPI 3.1 description of every v1 endpoint is at /api/v1/openapi.json. A plain text summary for language models is at /llms.txt, and MCP clients can read /.well-known/mcp.json. These three files hold no app data and need no key. No endpoint sends CORS headers, so call the API from a server rather than a browser.

Quotas

Tiers, units and headers

Free: 60 requests per minute, 1,000 units per day, 3 design briefs per day, 2 active keys. Pro: 300 requests per minute, 50,000 units per day, 200 design briefs per day, 10 active keys. There is no billing. Legacy keys (no tier assigned, including keys created before tiers and name-only console keys) get 300 requests per minute, 50,000 units per day and 200 design briefs per day, the same as Pro. Scopes are read, screens:hires and brief. New account keys start with read. Screenshot tools need screens:hires. get_design_brief needs brief. A legacy key with no scope list gets read only, the same as a new account key and needs an explicit scope list to reach screenshots or briefs. A null scope list on a free or pro key is unrestricted. Unit costs: 1 for lookups (search, app, listing, versions, rankings, tech stack, icons, charts, movers, list, export, flags), 2 for sdk_adoption, screenshots and design tokens, 3 for compare_apps, 10 for get_design_brief. Usage is batched into api_usage. Success responses send RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit and RateLimit-Policy. A 429 also sends Retry-After. TDN_API_DISABLED=1 returns 503 for key-authenticated traffic. TDN_MCP_DISABLED=1 disables MCP. TDN_MCP_DISABLED_TOOLS is a comma list of tool names.

Scope

Listed apps

v1 resolves every app listed in the catalog, tracked or not. Unknown IDs return 404. App responses include tracking (true when we collect ranks, ratings and versions for the app); history endpoints for an app we do not track return empty lists, not 404. Pass store=apple or store=google when the id alone is ambiguous. Endpoints added in November 2026 return { data, meta }. Every error returns { error, code } with a short code such as bad_request, unauthorized, not_found or rate_limited. List endpoints take limit and cursor and return nextCursor, which is null on the last page. The API only reads collected data and never fetches the stores on request.

Caching

CDN-friendly responses

Most JSON list/detail routes set public Cache-Control via publicJson. Export always disables shared caching and uses attachment disposition.

Endpoints

GET /api/v1/apps…

GET/api/v1/apps

List tracked apps (id, store, name, developer, category, iconUrl, active). Query: limit (1-500, default 500), cursor. Pass nextCursor back as cursor for the next page; it is null on the last page.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps"

Example response (shape)

{
  "apps": [
    {
      "id": "6670324846",
      "store": "apple",
      "name": "Grok",
      "developer": "X.AI LLC",
      "category": "Productivity",
      "iconUrl": "https://is1-ssl.mzstatic.com/…/512x512bb.jpg",
      "active": true
    }
  ],
  "count": 1,
  "total": 1,
  "nextCursor": null
}
GET/api/v1/apps/{id}

Snapshot summary for one listed app (tracking says whether we collect its data). Query: store=apple|google (required when ambiguous), country (default us). Public JSON cache via publicJson (s-maxage=600).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846?store=apple&country=us"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "tracking": true,
  "latestRating": 4.8,
  "ratingCount": 120000,
  "latestVersion": "1.2.3",
  "versionCount": 42,
  "rank": 12,
  "rankCountry": "us",
  "usRank": 12
}
GET/api/v1/apps/{id}/rankings

Latest global chart positions for the app. Query: store, chart_type (default top-free). Top-level chartType; each row is country, rank, recordedAt only. Priority hub mirror for rank history.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/rankings?store=apple&chart_type=top-free"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "chartType": "top-free",
  "rankings": [
    { "country": "us", "rank": 12, "recordedAt": "2026-06-26 00:00:00" }
  ],
  "count": 1
}
GET/api/v1/apps/{id}/versions

Version history with enrichment when collected (storeUpdatedAt, minOs, sizeBytes, contentRating, offersIap, adSupported, languages). Rows use serializeVersion camelCase fields. Query: store, limit (1-200, default 50).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/versions?store=apple&limit=20"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "versions": [
    {
      "version": "1.2.3",
      "releaseNotes": "…",
      "firstSeenAt": "2026-06-28T00:00:00.000Z",
      "minOs": "17.0",
      "sizeBytes": 104857600,
      "contentRating": "17+",
      "languages": ["EN"]
    }
  ],
  "count": 1
}
GET/api/compare

Compare bundle for tracked apps (ratings, ranks, versions). Query: apps=slug,slug or ids; days. Prefer for nightly competitor diffs.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/compare?apps=grok,chatgpt&days=90"

Example response (shape)

{ "apps": [ { "name": "Grok", "rating": 4.8 } ] }
GET/api/v1/apps/{id}/screenshots

In-app screenshot sessions. Each image uses src (signed R2 URL or null if R2 off), not url. Field names: buildNumber, capturedAt, screenName, screenType, etc.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/screenshots?store=apple"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "sessions": [
    {
      "version": "1.2.3",
      "buildNumber": "100",
      "capturedAt": "2026-06-18 10:00:00",
      "screenCount": 1,
      "images": [
        {
          "filename": "001-Home.png",
          "screenName": "Home",
          "screenType": "home",
          "category": null,
          "tags": null,
          "description": null,
          "depth": 0,
          "src": "https://…r2…/signed-or-null"
        }
      ]
    }
  ],
  "count": 1
}
GET/api/v1/apps/{id}/icons

Icons grouped by binary version under versions[], not a top-level icons[]. Each icon object uses src (signed URL or null).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/icons?store=apple"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "versions": [
    {
      "version": "1.2.3",
      "buildNumber": "100",
      "platform": "ios",
      "collectedAt": "2026-06-18 10:00:00",
      "icons": [
        {
          "kind": "launcher",
          "appearance": "any",
          "variantName": null,
          "format": "png",
          "isVector": false,
          "width": 1024,
          "height": 1024,
          "src": "https://…r2…/signed-or-null"
        }
      ]
    }
  ],
  "count": 1
}
GET/api/v1/apps/{id}/export

Tabular export only (not an intel JSON bundle). Required semantics: type=snapshots|rankings|versions (default snapshots), format=csv|json (default csv), days (default 90). Returns attachment body: CSV text or a JSON array of row objects with snake_case columns.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/export?store=apple&type=snapshots&format=json&days=7"

Example response (shape)

// format=json: JSON array of rows (Content-Disposition attachment)
[
  {
    "recorded_at": "2026-06-25 12:00:00",
    "rating": 4.8,
    "rating_count": 120000,
    "price": 0,
    "installs": null
  }
]

// type=rankings rows: recorded_at, country, category, chart_type, rank
// type=versions rows: version, release_notes, first_seen_at
// format=csv (default): same columns as a CSV file body, not wrapped in JSON
GET/api/v1/apps/search

Database search. Tracked apps first, then collected chart rows not already included. Query q is required (min 2 characters). limit is 1-50, default 20. Does not call the App Store or Play Store. Costs 1 unit.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/search?q=grok&limit=10"

Example response (shape)

{
  "query": "grok",
  "apps": [
    { "id": "6670324846", "store": "apple", "name": "Grok", "tracked": true }
  ],
  "count": 1
}
GET/api/v1/apps/{id}/listing

Collected store listing. description is null and descriptionStatus is not_collected (listing copy is not stored). subtitle is the catalog tagline when one exists, with subtitleSource catalog_tagline. releaseNotes come from the latest versions row. Screenshot src is a stored URL, not a live fetch. Costs 1 unit.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/listing?store=apple"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "subtitle": null,
  "subtitleSource": null,
  "description": null,
  "descriptionStatus": "not_collected",
  "releaseNotes": "Bug fixes",
  "screenshots": [{ "position": 0, "deviceType": "iphone", "src": "https://…stored…" }]
}
GET/api/v1/apps/{id}/design-tokens

Palette from a local icon file when one is on disk, otherwise the stored accent color. Typography is always unknown. Contrast ratios use WCAG relative luminance. No remote icon fetch. Costs 2 units.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/design-tokens?store=apple"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "source": "accent_color",
  "typography": "unknown",
  "colors": { "primary": "#111111", "accent": "#111111" }
}
GET/api/v1/apps/{id}/design-brief

Deterministic markdown brief from collected fields, cached per app and version. No model call and no live store fetch. Costs 10 units and counts as one design brief. Missing sections say Not collected. The guardrails section is always present.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/design-brief?store=apple"

Example response (shape)

{
  "appId": "6670324846",
  "store": "apple",
  "version": "1.2.3",
  "cached": false,
  "brief": "---\nname: design-brief-grok\n..."
}
GET/api/v1/sdk-adoption

Apps whose latest collected tech stack includes an SDK, plus share of apps with any latest stack and the earliest captured_at across versions. Query sdk is required. limit is 1-50. Database only. Costs 2 units.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/sdk-adoption?sdk=Firebase&limit=20"

Example response (shape)

{
  "sdk": "Firebase",
  "appsWithSdk": 4,
  "appsWithStack": 20,
  "share": 0.2,
  "firstSeenAt": "2026-06-01 00:00:00",
  "apps": [{ "appId": "6670324846", "store": "apple", "name": "Grok", "version": "1.2.3" }]
}
GET/api/v1/notes

Notes from the blog, newest first. Query: limit (1-50, default 20), cursor, tag. Returns { data, meta } with meta.nextCursor.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/notes?limit=2"

Example response (shape)

{
  "data": [
    { "slug": "grok-4-fast", "title": "…", "description": "…", "date": "2026-09-20", "updated": null, "tags": ["Grok"], "url": "https://techdevnotes.com/blog/grok-4-fast", "featuredImage": null }
  ],
  "meta": { "count": 1, "total": 12, "limit": 2, "nextCursor": "eyJvIjoyfQ" }
}
GET/api/v1/notes/{slug}

One note with its FAQ and the article body as markdown. Unknown slugs return 404.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/notes/grok-4-fast"

Example response (shape)

{
  "data": { "slug": "grok-4-fast", "title": "…", "date": "2026-09-20", "tags": ["Grok"], "faq": [], "markdown": "# …" }
}
GET/api/v1/rankings

Leaderboard of tracked apps in one chart, from the latest collection. Query: store (apple or google), country (default us), chart (top-free, top-paid, top-grossing), category, limit (1-200, default 100), cursor.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/rankings?country=us&chart=top-free"

Example response (shape)

{
  "data": [ { "rank": 1, "appId": "6448311069", "store": "apple", "name": "ChatGPT", "developer": "OpenAI", "iconUrl": "…" } ],
  "meta": { "store": "apple", "country": "us", "chart": "top-free", "category": "all", "recordedAt": "2026-11-01 00:18:03", "count": 1, "total": 40, "limit": 100, "nextCursor": null }
}
GET/api/v1/apps/{id}/rank-history

Chart rank over time for one app. Query: store, countries (comma list, up to 10, default us), chart, category and either days (1-730, default 30) or from and to (YYYY-MM-DD, at most 730 days apart). Rank history is kept for 730 days; rows before 18 Sep 2026 were pruned under the old 45-day limit, so earlier dates return no points.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/rank-history?countries=us,gb&days=30"

Example response (shape)

{
  "data": { "appId": "6670324846", "store": "apple", "chart": "top-free", "category": "all", "series": [ { "country": "us", "points": [ { "at": "2026-10-31 00:18:03", "rank": 3 } ] } ] },
  "meta": { "from": "…", "to": "…", "countries": 2, "points": 60, "truncated": false }
}
GET/api/v1/store-screenshots

Store listing screenshot gallery: one entry per app with counts, device types and preview URLs. Query: store, limit (1-100, default 50), cursor.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/store-screenshots?limit=10"

Example response (shape)

{
  "data": [ { "appId": "6670324846", "store": "apple", "appName": "Grok", "totalScreenshots": 10, "deviceTypes": ["iphone"], "previews": [ { "url": "https://…", "deviceType": "iphone", "position": 0 } ] } ],
  "meta": { "count": 1, "total": 80, "limit": 10, "nextCursor": "…" }
}
GET/api/v1/apps/{id}/store-screenshots

All store listing screenshots for one app, grouped by device. Query: store, device.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/apps/6670324846/store-screenshots"

Example response (shape)

{
  "data": { "appId": "6670324846", "store": "apple", "devices": [ { "deviceType": "iphone", "images": [ { "position": 0, "url": "https://…", "collectedAt": "…" } ] } ] },
  "meta": { "count": 10 }
}
GET/api/v1/tech-stack

Apps with an analyzed build. Query: limit (1-500, default 100), cursor. Each item has developer, developerSlug and iconUrl from the store listing (null when not known). /api/v1/tech-stack/{id} returns one app (query: store, version).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/tech-stack"

Example response (shape)

{
  "data": [ { "appId": "6670324846", "store": "apple", "appName": "Grok", "version": "1.2", "sdkCount": 31, "developer": "X Corp.", "developerSlug": "x-corp", "iconUrl": "https://is1-ssl.mzstatic.com/…/512x512bb.jpg" } ],
  "meta": { "count": 1, "total": 30, "limit": 100, "nextCursor": null }
}
GET/api/v1/x-flags

Latest public X feature flags. Query: search (up to 100 characters), limit (1-2000, default 500), cursor. /api/v1/x-flags/history lists changes (query: days 1-365, limit 1-1000).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/x-flags?search=grok"

Example response (shape)

{
  "data": [ { "key": "grok_…", "value": true } ],
  "meta": { "count": 1, "total": 1, "limit": 500, "nextCursor": null, "capturedAt": "…", "totalFlags": 301 }
}
GET/api/v1/movers

Biggest rank moves among tracked apps. Query: country, chart, limit (1-50, default 20).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/movers?country=us"

Example response (shape)

{
  "data": [ { "appId": "…", "name": "…", "currentRank": 4, "previousRank": 9, "change": 5 } ],
  "meta": { "country": "us", "chart": "top-free", "count": 1 }
}
GET/api/v1/daily-feed

The daily feed among the apps TechDevNotes tracks: rank moves, new top 10 entries, apps back in the top 10 for the first time since a stated date, new versions, size and minimum OS changes and rating changes, from two complete 00:00 UTC collection runs. Published at 03:00 UTC; a day that fails the data checks is stored as skipped with its reasons. Query: date (YYYY-MM-DD, optional; default is the latest published day). Every table row lists its source rows (table, id, recordedAt, run ids).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/daily-feed?date=2026-11-04"

Example response (shape)

{
  "data": { "schema": "tdn.daily-feed.v1", "date": "2026-11-04", "status": "published", "scope": "Among the apps TechDevNotes tracks", "freshness": "data from the 00:00 UTC run, 4 Nov 2026", "summary": { "answer": "…" }, "items": [ { "kind": "rank_movers", "answer": "…", "table": { "columns": [], "rows": [], "total": 1 }, "context": "…" } ] },
  "meta": { "date": "2026-11-04", "status": "published", "schema": "tdn.daily-feed.v1", "count": 1 }
}
GET/api/v1/daily-feed/metrics

Store facts for a published daily feed day, among the apps TechDevNotes tracks: App Store download size percentiles (nearest rank, never interpolated), minimum OS spread, the apps that need the newest minimum OS and the newest tracked apps in the US top free charts by original release date. Computed only from the store facts stored in that day’s complete 00:00 UTC run; a fact that cannot be backed fully is listed under skipped with its reason. Query: date (YYYY-MM-DD, optional; default is the latest published day), store (apple or google), genre (a store genre listed in genres), kind (size_percentiles, min_os_distribution, min_os_newest, chart_release_dates).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/daily-feed/metrics?store=apple&genre=Productivity"

Example response (shape)

{
  "data": { "schema": "tdn.feed-metrics.v1", "date": "2026-11-06", "slot": "2026-11-06 00:00:00", "scope": "Among the apps TechDevNotes tracks", "filters": { "store": "apple", "genre": "Productivity", "kind": null }, "genres": { "apple": [ { "genre": "Productivity", "apps": 40 } ], "google": [] }, "items": [ { "kind": "size_percentiles", "answer": "…", "table": { "columns": [], "rows": [], "total": 6 }, "context": "…" } ], "skipped": [] },
  "meta": { "date": "2026-11-06", "schema": "tdn.feed-metrics.v1", "count": 1, "skipped": 0 }
}
GET/api/v1/charts

A full collected store chart with app, country and category names filled in. Query: store (apple or google). Apple: country, category, type, limit. Google: country, category, collection, limit. A chart that has not been collected returns 404.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/charts?store=apple&country=us"

Example response (shape)

{
  "data": [ { "rank": 1, "id": "…", "name": "…", "artistName": "…" } ],
  "meta": { "store": "apple", "title": "Top Free", "country": "us", "countryName": "United States", "categoryName": "All", "count": 25 }
}
GET/api/v1/compare

Side by side ratings, ranks and release cadence. Query: apps (comma list of slugs or ids, up to 20), days (1-365), store, country. Costs 3 units.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/compare?apps=chatgpt,claude&days=30"

Example response (shape)

{
  "data": [ { "appId": "…", "name": "ChatGPT", "currentRating": 4.8, "rank": 2, "versionCount": 120 } ],
  "meta": { "store": "apple", "country": "us", "days": 30, "count": 2 }
}
GET/api/v1/search

Search across apps, versions, screenshots, developers, technologies and notes. Query: q (2-100 characters), limit (1-20, default 5).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/v1/search?q=grok"

Example response (shape)

{
  "data": { "apps": [], "versions": [], "screenshots": [], "developers": [], "technologies": [], "posts": [] },
  "meta": { "query": "grok", "limit": 5 }
}

Site intel

Collected screenshots, stacks, flags, movers, charts

GET/api/screenshots/search

Full-text search across collected in-app screenshots. Query: q (min 2 chars), limit (1-100, default 50).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/screenshots/search?q=onboarding&limit=20"

Example response (shape)

{
  "query": "onboarding",
  "count": 1,
  "images": [
    {
      "id": 1,
      "filename": "001-Home.png",
      "screenName": "Home",
      "screenType": "home",
      "appId": "6670324846",
      "store": "apple",
      "appName": "Grok",
      "version": "1.2.3",
      "src": "https://…r2…/signed"
    }
  ]
}
GET/api/tech-stack

Latest collected tech stack per tracked app (id, store, sdkCount). Detail: GET /api/tech-stack/{id}?store=&version=.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/tech-stack"

Example response (shape)

{
  "count": 1,
  "apps": [
    {
      "appId": "6670324846",
      "store": "apple",
      "appName": "Grok",
      "version": "1.2.3",
      "sdkCount": 42
    }
  ]
}
GET/api/x-flags

Latest collected X.com feature-flag snapshot. Query: search (substring on flag key). History: GET /api/x-flags/history?days=&limit=.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/x-flags?search=grok"

Example response (shape)

{
  "manifest": {
    "timestamp": "2026-08-29T00:00:00.000Z",
    "featureSetToken": "…",
    "totalCount": 1200,
    "flags": [{ "key": "example_flag", "value": true }]
  }
}
GET/api/movers

Tracked apps with the largest Top Free rank moves between the last two collected samples. Query: country (default us), chart_type (default top-free), limit (1-50).

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/movers?country=us&limit=10"

Example response (shape)

{
  "country": "us",
  "chartType": "top-free",
  "count": 1,
  "movers": [
    {
      "appId": "6670324846",
      "store": "apple",
      "name": "Grok",
      "currentRank": 12,
      "previousRank": 28,
      "change": 16
    }
  ]
}
GET/api/charts

App Store chart. Query: country (default us), category (default all), type (default top-free), limit (1-100). Returns the collected snapshot from the database, with title, countryName and categoryName filled in. A chart that has not been collected returns 404. The API never fetches the live App Store. stdio MCP get_charts (store=apple) uses this route. Streamable HTTP MCP get_charts reads the same collected snapshot.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/charts?country=us&category=all&type=top-free&limit=5"

Example response (shape)

{
  "result": {
    "country": "us",
    "categoryId": "all",
    "chartType": "top-free",
    "apps": [
      {
        "rank": 1,
        "name": "Grok",
        "artistName": "xAI",
        "appStoreId": "6670324846"
      }
    ]
  }
}
GET/api/play-charts

Google Play chart. Query: country (default us), category (default PRODUCTIVITY), collection (default TOP_FREE), limit (1-100). Returns the collected snapshot from the database. A chart that has not been collected returns 404. The API never fetches the live Play Store. stdio MCP get_charts (store=google) uses this route. Streamable HTTP MCP get_charts reads the same collected snapshot.

Request

curl -s -H "Authorization: Bearer tdn_YOUR_KEY" \
  "https://techdevnotes.com/api/play-charts?country=us&category=PRODUCTIVITY&collection=TOP_FREE&limit=5"

Example response (shape)

{
  "result": {
    "country": "us",
    "categoryId": "PRODUCTIVITY",
    "collection": "TOP_FREE",
    "apps": [
      {
        "rank": 1,
        "appId": "ai.x.grok",
        "title": "Grok",
        "developer": "xAI"
      }
    ]
  }
}
Streamable HTTP MCP get_charts reads the collected chart snapshot (no live scrape). stdio MCP get_charts calls /api/charts (Apple) and /api/play-charts (Google), which return the same snapshot and a 404 when it has not been collected.