Getting Started

Quick start

1. Get your API key

Contact us for early access. API keys are prefixed with di_live_.

2. Make your first request

Look up what technologies Notion uses:

curl "https://desktopinsights.com/api/v1/lookup?app=Notion&platform=macos" \
  -H "Authorization: Bearer di_live_your_key_here"

3. Explore the response

{
  "data": [{
    "app": {
      "name": "Notion",
      "slug": "notion",
      "developer": "Notion Labs, Incorporated",
      "platform": "macos",
      "currentVersion": "7.9.0",
      "runtime": "electron",
      "electronVersion": "39.6.0",
      "dependencyCount": 45,
      "appSizeBytes": 285253632,
      "architectures": ["arm64"],
      "minOsVersion": "12.0",
      "signed": true,
      "notarized": true
    },
    "sdkSummary": {
      "errorTrackingSdk": null,
      "analyticsSdk": null,
      "featureFlagSdk": null,
      "databaseSdk": "SQLite",
      "uiFramework": "React",
      "stateManagement": "Redux",
      "observabilitySdk": "electron-log",
      "autoUpdateSdk": "electron-updater"
    },
    "technologies": [
      { "name": "Electron", "version": "39.6.0", "category": "Runtime", "confidence": 100 },
      { "name": "React", "version": "16.13.1", "category": "UI Framework", "confidence": 80 },
      { "name": "Redux", "version": "2.2.3", "category": "State Management", "confidence": 80 },
      { "name": "SQLite", "version": "12.4.6", "category": "Database", "confidence": 80 },
      { "name": "electron-updater", "version": "4.1.2", "category": "Auto-Update", "confidence": 80 }
    ]
  }],
  "meta": {
    "requestId": "req_f0480c69",
    "resultCount": 1,
    "query": "Notion",
    "platform": "macos"
  }
}

Key concepts

App names and matching

You can look up apps by name (e.g., Slack, Notion) or by macOS bundle ID (e.g., com.tinyspeck.slackmacgap). The API tries exact match first, then slug match, then fuzzy name match.

Platforms

Desktop Insights covers macOS and Windows apps. Use the platform parameter to filter:

• ?platform=macos — macOS apps only
• ?platform=windows — Windows apps only
• Omit platform — returns results from both platforms

SDK summary

The sdkSummary object provides one flat field per SDK category. This is designed for sales tools like Clay — each field maps to a table column. A null value means no SDK was detected in that category, which represents a sales opportunity.

Confidence scores

Each detected technology has a confidence score:

Next steps

• Authentication — API key details
• Lookup — Full Lookup endpoint reference
• Clay Integration — Set up Desktop Insights in Clay