Merge pull request #20 from macrocosm-os/gen_1824_update_examples_for_DU_v1_9_75

GEN-1824: Changes based on Data Universe update to OnDemandData in v1.9.75 release

Author: lew-sword

README.md

@@ -85,6 +85,10 @@ print(polled_response)
 
 SN13 is focused on large-scale data collection. With the OnDemandAPI, you can run precise, real-time queries against platforms like X (Twitter) and Reddit (YouTube forthcoming).
 
+As of data-universe release [v1.9.75](https://github.com/macrocosm-os/data-universe/releases/tag/v1.9.75):
+- All keywords in an OnDemandData request will be present in the returned post/comment data.
+- For Reddit requests, the first keyword in the list corresponds to the requested subreddit, and subsequent keywords are treated as normal.
+
 Use the synchronous `Sn13Client` to query historical or current data based on users, keywords, and time range.
 
 ### Query Example
@@ -95,12 +99,12 @@ import macrocosmos as mc
 client = mc.Sn13Client(api_key="<your-api-key>", app_name="my_app")
 
 response = client.sn13.OnDemandData(
-    source='X',  # or 'Reddit'
-    usernames=["@nasa"],  # Optional, up to 5 users
-    keywords=["galaxy"],  # Optional, up to 5 keywords
-    start_date='2025-04-15',  # Defaults to 24h range if not specified
-    end_date='2025-05-15',  # Defaults to current time if not specified
-    limit=1000  # Optional, up to 1000 results
+    source='X',                 # or 'Reddit'
+    usernames=["@nasa"],        # Optional, up to 5 users
+    keywords=["galaxy"],        # Optional, up to 5 keywords
+    start_date='2025-04-15',    # Defaults to 24h range if not specified
+    end_date='2025-05-15',      # Defaults to current time if not specified
+    limit=1000                  # Optional, up to 1000 results
 )
 
 print(response)

examples/sn13_on_demand_data.py

@@ -1,5 +1,9 @@
 """
 Example of using the SN13 On Demand Data Streaming service with Macrocosmos SDK.
+
+As of data-universe release v1.9.75:
+    - All keywords in the OnDemandData request will be present in the returned post/comment data.
+    - For Reddit requests, the first keyword in the list corresponds to the requested subreddit, and subsequent keywords are treated as normal.
 """
 
 import os

examples/sn13_on_demand_data_async.py

@@ -1,6 +1,10 @@
 """
 Example demonstrating concurrent async operations with the SN13 On Demand Data service.
 Shows how multiple requests can be processed simultaneously in an async context.
+
+As of data-universe release v1.9.75:
+    - All keywords in the OnDemandData request will be present in the returned post/comment data.
+    - For Reddit requests, the first keyword in the list corresponds to the requested subreddit, and subsequent keywords are treated as normal.
 """
 
 import os
@@ -59,9 +63,9 @@ async def main():
             "request_id": 2,
         },
         {
-            "source": "x",
+            "source": "reddit",
             "usernames": ["ISS", "ESA"],
-            "keywords": ["galaxy", "universe", "cosmos"],
+            "keywords": ["r/space", "universe"],
             "request_id": 3,
         },
     ]

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "macrocosmos"
-version = "1.1.1"
+version = "1.1.2"
 description = "The official Python SDK for Macrocosmos"
 readme = "README.md"
 license = "Apache-2.0"