From de33793cbc1761e93261ef8be48cbab7572d695e Mon Sep 17 00:00:00 2001
From: gravel <qsj4di+aybgdjbxur7e8@sharklasers.com>
Date: Thu, 1 Jun 2023 15:27:34 +0000
Subject: [PATCH] Extend /listings endpoint

---
 PROTOCOL.md | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/PROTOCOL.md b/PROTOCOL.md
index ed1c807..0ef7c74 100644
--- a/PROTOCOL.md
+++ b/PROTOCOL.md
@@ -101,13 +101,34 @@ See <https://github.com/oxen-io/session-pysogs/blob/dev/sogs/routes/onion_reques
 
 ### GET `/listings`
 
-Description: Enumerate the identifiers of the listings hosted by the listing provider.
+Description: Enumerate the listings hosted by the listing provider with listing-specific details.
 
 Example response:
 
 ```json
 {
-    listings: ["tech", "languages", "privsec", "casual", "nsfw", "all"]
+    listings: {
+      "tech": {
+          name: "Tech Communities",
+          communities: 5
+      },
+      "privsec": {
+          name: "Privacy & Security",
+          communities: 4
+      },
+      "casual": {
+          name: "Casual Communities",
+          communities: 3
+      },
+      "nsfw": {
+          name: "18+ Communities",
+          communities: 3
+      }
+      "all": {
+          name: "All Communities",
+          communities: 10
+      }
+    }
 }
 ```