---
schema_version: "1"
id: 471cabf0c3a57d7c166fec4ef0213030d8bcf3f719d373c7293906bb432d36a6
title: Query Data Graph Data
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-query-guide/references/data-cloud-query-api-reference/data-graph/c360a-api-data-graphs-overview.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-data-graphs-overview.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: b832b6330248f3c6e572bdc11ae25a6cc2fa41ad2e7908e84e5729eaaadaba06
products:
  - Data 360 Query Guide
  - Data 360 Developer Documentation
---
# Query Data Graph Data

The Data Graph API provides a powerful way to query and analyze data from Data 360 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.

## Prerequisites

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

## Metadata Endpoint

- [**GET /api/v1/dataGraph/metadata**](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-v1-data-graphs-metadata.md)
  - 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

## Data Access Endpoints

- [**GET /api/v1/dataGraph/{dataGraphEntityName}/{id}**](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-v1-data-graphs-name-id.md)

  - 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=[]**](c360a-api-v1-data-graphs-lookup.md)
  - Queries data using lookup keys from primary or participating data model objects
  - Supports flexible data retrieval based on various key fields

## Additional Resources

- [_Salesforce Help_: Data Graphs](https://help.salesforce.com/s/articleView?id=data.c360_a_data_graphs.htm&type=5)
- [User Roles and Permission Sets in Data 360](https://help.salesforce.com/s/articleView?id=data.c360_a_userpermissions.htm&type=5)
- [Getting Started with Data Cloud API](https://developer.salesforce.com/docs/data/data-cloud-ref/guide/c360a-getting-started-with-cdp.html)
- [Retrieve Metadata](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/c360a-api-metadata-api.md)