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 JSONGET/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 }
}