Query APIs

Out-of-the-box Query APIs for the most common analytics use cases and data visualizations.

SQL API

Execute SQL queries from your application.

Counter

Get a single aggregated value for a time range.

Data Grid

Get a table of records from a Data Pool.

Leaderboard

Get aggregated values grouped by common dimensions.

Metric Report

Get multiple aggregated values grouped by common dimensions.

Time Series

Get ready-to-chart time series data.

Top Values

Get the most frequent non-null values in a column.

You can test your GraphQL API requests without writing a single line of code in our API Playground.

Common features

All of our APIs offer the following features:

Pre-defined or inline metric aggregations

Make API requests using pre-defined or inline Metric definitions.

Query using an in-line metric definition:

Query

query TimeSeriesExample {
  timeSeries(input: {
    metric: {
      count: {
        dataPool: {
          name: "TacoSoft Demo Data"
        }
      }
    }:
  }) {
    ...
  }
}

Query using a pre-defined metric definition by ID:

Query

query TimeSeriesExample {
  timeSeries(input: {
    metric: {
      id: "METXXXXXXXXXXXXXXXXXXXXXXXXXX"
    }
  }) {
    ...
  }
}

Query using a pre-defined metric definition by name:

Query

query TimeSeriesExample {
  timeSeries(input: {
    metric: {
      name: "sales"
    }
  }) {
    ...
  }
}

Built-in relative time ranges

Absolute time ranges

Absolute time ranges allow for precise date and time selection.

Query

query TimeSeriesExample {
  timeSeries(input: {
    ...
    timeRange: {
      absolute: { start: "2024-01-01", end: "2024-01-05" }
    }
  }) {
    ...
  }
}

Filtering

Timezone support

Calculates the relative time ranges for the given time zone, allowing for accurate representation of data across different geographical locations.

Query

query TimeSeriesExample {
  timeSeries(input: {
    ...
    timeZone: "America/Los_Angeles"
  }) {
    ...
  }
}

FINAL modifier

Secured by Access Policies

Multi-tenant JWT tokens

Authentication

Out-of-the-box Query APIs for the most common analytics use cases and data visualizations.

SQL API

Execute SQL queries from your application.

Counter

Get a single aggregated value for a time range.

Data Grid

Get a table of records from a Data Pool.

Leaderboard

Get aggregated values grouped by common dimensions.

Metric Report

Get multiple aggregated values grouped by common dimensions.

Time Series

Get ready-to-chart time series data.

Top Values

Get the most frequent non-null values in a column.

You can test your GraphQL API requests without writing a single line of code in our API Playground.

Common features

All of our APIs offer the following features:

Pre-defined or inline metric aggregations

Make API requests using pre-defined or inline Metric definitions.

Query using an in-line metric definition:

Query

query TimeSeriesExample {
  timeSeries(input: {
    metric: {
      count: {
        dataPool: {
          name: "TacoSoft Demo Data"
        }
      }
    }:
  }) {
    ...
  }
}

Query using a pre-defined metric definition by ID:

Query

query TimeSeriesExample {
  timeSeries(input: {
    metric: {
      id: "METXXXXXXXXXXXXXXXXXXXXXXXXXX"
    }
  }) {
    ...
  }
}

Query using a pre-defined metric definition by name:

Query

query TimeSeriesExample {
  timeSeries(input: {
    metric: {
      name: "sales"
    }
  }) {
    ...
  }
}

Built-in relative time ranges

Absolute time ranges

Absolute time ranges allow for precise date and time selection.

Query

query TimeSeriesExample {
  timeSeries(input: {
    ...
    timeRange: {
      absolute: { start: "2024-01-01", end: "2024-01-05" }
    }
  }) {
    ...
  }
}

Filtering

Timezone support

Calculates the relative time ranges for the given time zone, allowing for accurate representation of data across different geographical locations.

Query

query TimeSeriesExample {
  timeSeries(input: {
    ...
    timeZone: "America/Los_Angeles"
  }) {
    ...
  }
}

FINAL modifier

Secured by Access Policies

Multi-tenant JWT tokens

Authentication

SQL API

Counter

Data Grid

Leaderboard

Metric Report

Time Series

Top Values

Common features

Get Started

APIs

Metrics

Guides

Query APIs

SQL API

Counter

Data Grid

Leaderboard

Metric Report

Time Series

Top Values

Common features

SQL API

Counter

Data Grid

Leaderboard

Metric Report

Time Series

Top Values

​Common features

Get Started

APIs

Metrics

Guides

SQL API

Counter

Data Grid

Leaderboard

Metric Report

Time Series

Top Values

​Common features

Common features

Common features