From ea56143179fe31df4594957a760484c5eeb61e1e Mon Sep 17 00:00:00 2001
From: shmam <shmam@github.com>
Date: Tue, 24 Mar 2026 10:37:37 -0700
Subject: [PATCH 1/2] adding search example responses

---
 api/registry.npmjs.com/search.yaml | 47 ++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/api/registry.npmjs.com/search.yaml b/api/registry.npmjs.com/search.yaml
index 46ce1a1..509e1f2 100644
--- a/api/registry.npmjs.com/search.yaml
+++ b/api/registry.npmjs.com/search.yaml
@@ -13,6 +13,9 @@ components:
               code:
                 type: string
                 description: Error code for this response
+          example:
+            error: "'text' query parameter is required"
+            code: "ERR_TEXT_MISSING"
     SearchResults:
       description: Search results
       content:
@@ -126,6 +129,50 @@ components:
                 type: string
                 format: date-time
                 description: The current time
+          example:
+            objects:
+              - downloads:
+                  monthly: 412841
+                  weekly: 93602
+                dependents: 20
+                updated: "2026-03-24T07:35:20.725Z"
+                searchScore: 1538.6487
+                package:
+                  name: "@npm/types"
+                  keywords:
+                    - "npm registry"
+                    - "types"
+                    - "typescript"
+                    - "definitions"
+                    - "typings"
+                  version: "2.1.0"
+                  description: "Typescript definitions for npm registry content"
+                  sanitized_name: "@npm/types"
+                  publisher:
+                    email: "reggi@github.com"
+                    username: "reggi"
+                  maintainers:
+                    - email: "npm@npmjs.com"
+                      username: "npm"
+                    - email: "ops@npmjs.com"
+                      username: "npmci"
+                  license: "MIT"
+                  date: "2025-04-28T20:18:14.734Z"
+                  links:
+                    homepage: "https://github.com/npm/types#readme"
+                    repository: "git+https://github.com/npm/types.git"
+                    bugs: "https://github.com/npm/types/issues"
+                    npm: "https://www.npmjs.com/package/@npm/types"
+                score:
+                  final: 1538.6487
+                  detail:
+                    popularity: 1
+                    quality: 1
+                    maintenance: 1
+                flags:
+                  insecure: 0
+            total: 1
+            time: "2026-03-24T07:35:20.725Z"
 paths:
   /-/v1/search:
     get:

From efbd91a50c238f96c4df83e2222188cba5d2186b Mon Sep 17 00:00:00 2001
From: sam crochet <shmam@github.com>
Date: Tue, 24 Mar 2026 10:42:31 -0700
Subject: [PATCH 2/2] Update api/registry.npmjs.com/search.yaml

Co-authored-by: Gar <wraithgar@github.com>
---
 api/registry.npmjs.com/search.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/api/registry.npmjs.com/search.yaml b/api/registry.npmjs.com/search.yaml
index 509e1f2..aaa1585 100644
--- a/api/registry.npmjs.com/search.yaml
+++ b/api/registry.npmjs.com/search.yaml
@@ -149,8 +149,8 @@ components:
                   description: "Typescript definitions for npm registry content"
                   sanitized_name: "@npm/types"
                   publisher:
-                    email: "reggi@github.com"
-                    username: "reggi"
+                    email: "npm-robot@github.com"
+                    username: "npm-robot"
                   maintainers:
                     - email: "npm@npmjs.com"
                       username: "npm"