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
  }
}