Skip to main content

Sites

Overview

The space parameter defines the scope of sites you want to query in your analysis. You can query data from single or multiple sites simultaneously.

Parameters

ParameterDescriptionValuesRequired
sArray of site IDs to include in the queryArray of integersYes

Usage Notes

  • Site IDs are numerical identifiers unique to each site in your Piano Analytics account
  • You can query multiple sites in a single request for comparative analysis
  • When using multiple sites with relative periods, timezone handling follows the most easterly timezone

Examples

Example 1: Single site query

Query data from one specific site.

{
"space": {
"s": [123456789]
}
}

Example 2: Multiple sites query

Query data from multiple sites for comparison.

{
"space": {
"s": [123456789, 1234567890]
}
}

Example 3: Multi-site analysis with breakdown

Analyze multiple sites with device type breakdown.

{
"space": {
"s": [123456789, 1234567890, 9876543210]
},
"columns": ["site_id", "device_type", "m_visits"],
"breakdown": {
"columns": ["geo_country"],
"max-results": 10
}
}