From 5c749cf9d2b8ce7b5d205ef61c7f380756d5a647 Mon Sep 17 00:00:00 2001
From: Lawrence Tong <lawrencetong1030@gmail.com>
Date: Thu, 25 Jun 2026 21:23:50 -0500
Subject: [PATCH 1/3] feat: replace queryString param with q

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 client/db/index.jsx              | 4 ++--
 client/tools/api-docs/query.html | 4 ++--
 routes/api/query.js              | 2 ++
 3 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/client/db/index.jsx b/client/db/index.jsx
index 4f7d742b4..906a6f5f2 100644
--- a/client/db/index.jsx
+++ b/client/db/index.jsx
@@ -39,7 +39,7 @@ function QueryForm () {
     subcategories: initialParams.get('subcategories') ? initialParams.get('subcategories').split(',') : [],
     alternateSubcategories: initialParams.get('alternateSubcategories') ? initialParams.get('alternateSubcategories').split(',') : []
   });
-  const [queryString, setQueryString] = React.useState(initialParams.get('queryString') ?? '');
+  const [queryString, setQueryString] = React.useState(initialParams.get('q') ?? '');
   const [maxReturnLength, setMaxReturnLength] = React.useState(initialParams.get('maxReturnLength') ?? '');
   const [setName, setSetName] = React.useState(initialParams.get('setName') ?? '');
   const [searchType, setSearchType] = React.useState(initialParams.get('searchType') ?? 'all');
@@ -133,7 +133,7 @@ function QueryForm () {
     }
 
     const unfilteredParams = {
-      queryString,
+      q: queryString,
       ...categoryManager.export(),
       difficulties: getDropdownValues('difficulties'),
       maxReturnLength,
diff --git a/client/tools/api-docs/query.html b/client/tools/api-docs/query.html
index bdf825421..b05295177 100644
--- a/client/tools/api-docs/query.html
+++ b/client/tools/api-docs/query.html
@@ -55,7 +55,7 @@ <h4 class="mt-4 md-2" id="parameters">Parameters</h4>
             <ul class="list-group list-group-flush">
                 <li class="list-group-item">
                     <div>
-                        <code>queryString</code><code class="text-muted">: string</code>
+                        <code>q</code><code class="text-muted">: string</code>
                         <code class="text-muted float-end fw-semibold">default: ""</code>
                     </div>
                     <div>
@@ -336,7 +336,7 @@ <h4 class="mt-4 md-2" id="returns">Returns</h4>
                     </div>
                     <div>
                         The exact string used to search the MongoDB database.
-                        This may differ from the queryString passed in as a parameter:
+                        This may differ from the q passed in as a parameter:
                         <ul>
                             <li>If <code>regex</code> is <code>false</code>, then regex characters are escaped.</li>
                         </ul>
diff --git a/routes/api/query.js b/routes/api/query.js
index 302986b78..bc3c0368b 100644
--- a/routes/api/query.js
+++ b/routes/api/query.js
@@ -27,6 +27,8 @@ router.get('/', async (req, res) => {
   req.query = validateInt.tossupPagination(req.query);
   req.query = validateCategoryBundle(req.query);
 
+  req.query.queryString = req.query.q;
+
   if (req.query.setName) {
     req.query.setName = req.query.setName.split(',').map(s => s.trim());
   }

From e3068e6c4c253628771a28d414791cccbb9b5a71 Mon Sep 17 00:00:00 2001
From: Lawrence Tong <lawrencetong1030@gmail.com>
Date: Thu, 25 Jun 2026 21:28:20 -0500
Subject: [PATCH 2/3] fix: changes wording of queryString in api docs

---
 client/tools/api-docs/query.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/client/tools/api-docs/query.html b/client/tools/api-docs/query.html
index b05295177..629223701 100644
--- a/client/tools/api-docs/query.html
+++ b/client/tools/api-docs/query.html
@@ -336,7 +336,7 @@ <h4 class="mt-4 md-2" id="returns">Returns</h4>
                     </div>
                     <div>
                         The exact string used to search the MongoDB database.
-                        This may differ from the q passed in as a parameter:
+                        This may differ from the queryString (q) passed in as a parameter:
                         <ul>
                             <li>If <code>regex</code> is <code>false</code>, then regex characters are escaped.</li>
                         </ul>

From a796181d59b7bfe581eb1d186404d8e83c6444a0 Mon Sep 17 00:00:00 2001
From: Lawrence Tong <lawrencetong1030@gmail.com>
Date: Fri, 26 Jun 2026 08:12:55 -0500
Subject: [PATCH 3/3] feat: support legacy queryString param as fallback for q

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 client/db/index.jsx | 2 +-
 routes/api/query.js | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/client/db/index.jsx b/client/db/index.jsx
index 906a6f5f2..4738de845 100644
--- a/client/db/index.jsx
+++ b/client/db/index.jsx
@@ -39,7 +39,7 @@ function QueryForm () {
     subcategories: initialParams.get('subcategories') ? initialParams.get('subcategories').split(',') : [],
     alternateSubcategories: initialParams.get('alternateSubcategories') ? initialParams.get('alternateSubcategories').split(',') : []
   });
-  const [queryString, setQueryString] = React.useState(initialParams.get('q') ?? '');
+  const [queryString, setQueryString] = React.useState(initialParams.get('q') ?? initialParams.get('queryString') ?? '');
   const [maxReturnLength, setMaxReturnLength] = React.useState(initialParams.get('maxReturnLength') ?? '');
   const [setName, setSetName] = React.useState(initialParams.get('setName') ?? '');
   const [searchType, setSearchType] = React.useState(initialParams.get('searchType') ?? 'all');
diff --git a/routes/api/query.js b/routes/api/query.js
index bc3c0368b..973020a04 100644
--- a/routes/api/query.js
+++ b/routes/api/query.js
@@ -27,7 +27,7 @@ router.get('/', async (req, res) => {
   req.query = validateInt.tossupPagination(req.query);
   req.query = validateCategoryBundle(req.query);
 
-  req.query.queryString = req.query.q;
+  req.query.queryString = req.query.q ?? req.query.queryString;
 
   if (req.query.setName) {
     req.query.setName = req.query.setName.split(',').map(s => s.trim());