---
schema_version: "1"
id: 2eebbfecfcd3b11e4caa5609f0b7b8ae082e50fae2a88c017162bc16eb291b6a
title: Semantic Query API
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/semantic-layer/guides/query-api.md
canonical_url: https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 22a145c63f5e1b7978667e71989a8facaa461b90a7d415999c2d1e21ef5bfc15
products:
  - Tableau Semantics Layer APIs
  - Data 360 Developer Documentation
---
# Semantic Query API

The Semantic Query API allows you to leverage your data in Data 360 through the Semantic Layer in order to answer a variety of business questions. You send a Semantic Query that references the dimensions, measurements, and data objects defined in your Semantic Model, and the API resolves relationships, applies filters and aggregations, and returns the result.

## Use the guides

Use the links to the left to explore each part of the Semantic Query API:

- [Overview](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-overview.md) — the request shape, how a query references a Semantic Model, and how queries are executed.
- [Dimensions, Measurements, and Data Objects](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-data-objects.md) — select fields from the data objects in your model.
- [Relationships and Joins](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-relationships.md) — query across related data objects.
- [Parameters](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-parameters.md) — supply values to parameterized models at query time.
- [Calculated Fields](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-calculated-fields.md) — reference model calculations or define inline ones.
- [Functions and Formulas](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-functions.md) — the formula language used in expressions.
- [Filtering](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-filtering.md) — restrict rows with object, model, context, and aggregate filters.
- [Grouping](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-grouping.md) — group rows by dimensions.
- [Aggregation and Totals](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-aggregation.md) — summarize measures and add subtotals and grand totals.
- [Sorting and Limiting](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-sorting-limiting.md) — order results and cap the number of rows.
- [Predict and Forecast](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-predict-forecast.md) — query predicted values from EDC models and forecasted time series.
- [Logical Views](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-logical-views.md) — query standard, union, custom SQL, and organizational-hierarchy logical views composed in the model.
- [Shared Dimensions](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-shared-dimensions.md) — analyze multiple fact tables along a common dimension.
- [Currency and Fiscal Handling](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-currency-fiscal.md) — currency conversion and fiscal calendar behavior.
- [SemanticQueryRequest Fields](https://developer.salesforce.com/docs/data/semantic-layer/guide/query-api-in-depth-fields.md) — the complete request schema.

Each query topic links to the [Authoring API Entities](https://developer.salesforce.com/docs/data/semantic-layer/guide/connect-api-in-depth-entities.md) that define the corresponding metadata in the Semantic Model.