---
schema_version: "1"
id: 8d7f07256553e9ea5832837df55db6a25912e773b32c01217549f6b9a1e0495c
title: Get Descriptive and Diagnostic Insights Programmatically
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/analytics/264-0-0/bi_edd_insight_api.md
canonical_url: https://help.salesforce.com/s/articleView?id=analytics.bi_edd_insight_api.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 56ed9f9c4a0ad20c35d0d8d757d3dad995500a6908a2c08053efce59e5d7326f
description: Use Einstein Discovery's Insights API to embed insights from your model into any website, application, or dashboard. Insights contain values that quantify the impact on the selected model goal, along with narrative descriptions of those values. With the Insights API, client applications can obtain a summary of the top positive and negative insights, query insight details further, and then apply their own narratives to the insight values. You can also query insights by insight type (descriptive or diagnostic).
products:
  - CRM Analytics
  - Cross Cloud
release: "264"
---
# Get Descriptive and Diagnostic Insights Programmatically

Use Einstein Discovery's Insights API to embed insights from your model into any website, application, or dashboard. Insights contain values that quantify the impact on the selected model goal, along with narrative descriptions of those values. With the Insights API, client applications can obtain a summary of the top positive and negative insights, query insight details further, and then apply their own narratives to the insight values. You can also query insights by insight type (descriptive or diagnostic).

### Required Editions

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/images/icon_note.png)

Note Einstein Discovery stories are now models. We wish we could snap our fingers to update the name everywhere, but you can expect to see the previous name in a few places until we replace it.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d166976e41">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d166976e41 ">To run REST API commands on the Insights API:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d166976e41 ">Use Einstein Discovery</td>

          </tr>
        </tbody>
      </table>

The Insights API provides REST API endpoints that enable you to:

- query descriptive and diagnostic insights
- get insight summaries
- get metadata for models and model versions

Each resource (models, model versions, and insights) has a unique id. These REST endpoints allow you read-only access.

To interact with the Insights API, use your favorite REST client. You must have a external client app that handles Salesforce authentication for your REST client. To learn more, take the [External Client App Basics](https://trailhead.salesforce.com/content/learn/modules/external-client-app-basics) Trailhead module.

#### See Also

- [_Salesforce Help_: Einstein Discovery REST API Developer Guide](https://developer.salesforce.com/doc/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_rest_sdd_overview.htm)