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
Parameter | Description | Values | Required |
---|---|---|---|
s | Array of site IDs to include in the query | Array of integers | Yes |
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
}
}