Query Data Graph Data

The Data Graphs 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.

  • Metadata Access: Retrieve information about available data graphs, including primary data model objects, related objects, and their fields
  • Flexible Lookup: Query data using primary keys or lookup keys from any participating data model object
  • Record-based Access: Retrieve specific records by their unique identifiers
  • Comprehensive Data Model: Access to the complete data model structure and relationships
  • Live vs Precalculated Queries: 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
  • All API endpoints require proper authentication using an access token
  • Example URLs use {TSE} to represent your tenant-specific endpoint
  • Data access is subject to user permissions and role assignments
  • The API follows REST standards for consistency and ease of use