Add hourly export docs

Author: adriaandotcom

_docs/50_api/20_export-data-points.md

@@ -7,7 +7,7 @@ redirect_from:
   - /api/export-pageviews
   - /api/export-page-views
   - /api/export-events
-last_modified_at: 2022-11-12
+last_modified_at: 2025-07-04
 fields: added_iso,country_code,datapoint,device_type,path,query,query_and_path,session_id,utm_source,utm_campaign,utm_content,utm_medium
 ---
 
@@ -17,6 +17,27 @@ With this API you can export raw data points (without sampling). Data points are
 
 When using the API, it's recommended [to generate the export URL](/api/helpers#generate-export-url) via [the export your data interface](/export-data). It has a simple UI where fields can be selected without any coding or technical knowledge.
 
+## Hourly data export
+
+You can now export data for specific hours of a day. This allows for more granular data analysis when you need to understand traffic patterns within a single day.
+
+To export hourly data, append the hour to your date in the format `YYYY-MM-DDTHH` where `HH` is the hour in 24-hour format (00-23).
+
+**Important constraints for hourly exports:**
+
+- Both `start` and `end` parameters must include the hour
+- The start and end dates must be the same (you can only export hourly data for a single day at a time)
+- Hours must be between 00 and 23
+
+**Example:**
+
+```bash
+# Export data for 2PM on July 4th, 2025
+curl "https://simpleanalytics.com/api/export/datapoints?version={{ site.api_version }}&format=csv&hostname=example.com&start=2025-07-04T14&end=2025-07-04T14&fields=added_iso,path" \
+     -H 'User-Id: sa_user_id_...' \
+     -H 'Api-Key: sa_api_key_...'
+```
+
 <details>
 <summary>Available fields in export</summary>
 <div markdown="1">
@@ -95,10 +116,17 @@ You can specify all fields you like to export. Add them as a comma seperated lis
 To test if your API key works correctly you can replace the example values of this cURL example with your own.
 
 ```bash
+# Export daily data
 curl "https://simpleanalytics.com/api/export/datapoints?version={{ site.api_version }}&format=csv&hostname=simpleanalytics.com&start={{ "now" | date: '%s' | minus: 2592000 | date: '%Y-%m-%d' }}&end={{ "now" | date: '%Y-%m-%d' }}&robots=false&timezone=Europe%2FAmsterdam&fields=added_iso,path&type=pageviews" \
      -H 'User-Id: sa_user_id_00000000-0000-0000-0000-000000000000' \
      -H 'Api-Key: sa_api_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
      -H 'Content-Type: text/csv'
+
+# Export hourly data (for 3PM today in Amsterdam)
+curl "https://simpleanalytics.com/api/export/datapoints?version={{ site.api_version }}&format=csv&hostname=simpleanalytics.com&start={{ "now" | date: '%Y-%m-%d' }}T15&end={{ "now" | date: '%Y-%m-%d' }}T15&robots=false&timezone=Europe%2FAmsterdam&fields=added_iso,path&type=pageviews" \
+     -H 'User-Id: sa_user_id_00000000-0000-0000-0000-000000000000' \
+     -H 'Api-Key: sa_api_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
+     -H 'Content-Type: text/csv'
 ```
 
 </div>