Query Data Graph Data

The Data Graph API provides a powerful way to query and analyze data from Data Cloud data graphs. This API allows you to retrieve metadata about available data graphs and query the data with flexible lookup options.

A data graph combines and transforms normalized table data from data model objects (DMOs) into new, materialized views of your data. Because the data is precalculated, you can make more calls, and queries respond in near real time. Query your precalculated data graphs or retrieve real-time data with a live query. Live queries are longer-latency and have higher-credit consumption in exchange for up-to-date information.

• Data Cloud licenses must be provisioned for your org
• Users must have appropriate roles and permissions assigned
• Authentication requires a valid access token

• GET /api/v1/dataGraph/metadata
  • Retrieves metadata for all accessible data graph objects
  • Returns primary data model objects, related objects, and their fields
  • Supports filtering by specific data graph name

• GET /api/v1/dataGraph/{dataGraphEntityName}/{id}

  • Retrieves specific records from a data graph by their unique identifier
  • Returns complete record data including all related fields

• GET /api/v1/dataGraph/{dataGraphEntityName}?lookupKeys=[]

  • Queries data using lookup keys from primary or participating data model objects
  • Supports flexible data retrieval based on various key fields

• Salesforce Help: Data Graphs
• User Roles and Permission Sets in Data Cloud
• Getting Started with Data Cloud API
• Retrieve Metadata