Search the public site through the API

Full-text on Postgres, stemmed in the language searched; word matching
elsewhere.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

public/api-types.d.ts

@@ -268,6 +268,21 @@ export interface PublicRepository {
   good_first_issues: PublicIssue[];
 }
 
+export interface PublicSearchResult {
+  type: 'page' | 'project' | 'service' | 'call' | 'member' | 'technology';
+  id: number;
+  title: string;
+  /**
+   * Plain text around the first match.
+   */
+  excerpt: string;
+  path?: string;
+  /**
+   * Higher is a better match. Only comparable within one response.
+   */
+  score: number;
+}
+
 export interface PublicService {
   id: number;
   locale: string;
@@ -382,6 +397,7 @@ export interface PublicApiPayloads {
   '/public/v1/site': { locales: ({ code: string; name: string; flag: string; is_default: boolean })[]; default_locale: string; content_version: number; submissions_enabled: boolean; stats: { projects: number; active_projects: number; members: number; open_calls: number; good_first_issues: number; stars: number } };
   '/public/v1/slugs': Record<string, ({ id: number; updated_at: string; alternates: Record<string, string> })[]>;
   '/public/v1/redirects': ({ from: string; to: string; status: 301 | 302; locale?: string })[];
+  '/public/v1/search': PublicSearchResult[];
   '/public/v1/projects': PublicProject[];
   '/public/v1/projects/{slug}': PublicProject;
   '/public/v1/members': PublicMember[];

public/openapi.yaml

@@ -267,6 +267,55 @@ paths:
                           description: Null applies in every language.
         "503": { $ref: "#/components/responses/Maintenance" }
 
+  /public/v1/search:
+    get:
+      tags: [Public]
+      summary: Search the site
+      description: |
+        What the site shows that matches some words, in the request's
+        language, best match first: published pages, projects and services,
+        open calls, public members, and technologies in use.
+
+        Full-text in production — words are stemmed in the language searched,
+        so "proyectos" finds "proyecto", and a title match ranks above one in
+        the body. `path` is where the result lives on the site; null for a
+        technology, which has no address on this side.
+      security: []
+      parameters:
+        - $ref: "#/components/parameters/Lang"
+        - name: q
+          in: query
+          required: true
+          schema: { type: string, minLength: 2, maxLength: 120 }
+        - name: type[]
+          in: query
+          description: "Limit to some kinds: `page`, `project`, `service`, `call`, `member`, `technology`."
+          schema:
+            type: array
+            items: { type: string, enum: [page, project, service, call, member, technology] }
+        - name: limit
+          in: query
+          schema: { type: integer, minimum: 1, maximum: 50, default: 20 }
+      responses:
+        "200":
+          description: Results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items: { $ref: "#/components/schemas/PublicSearchResult" }
+                  meta:
+                    type: object
+                    properties:
+                      query: { type: string }
+                      locale: { type: string }
+                      count: { type: integer }
+        "422": { $ref: "#/components/responses/ValidationError" }
+        "503": { $ref: "#/components/responses/Maintenance" }
+
   /public/v1/projects:
     get:
       tags: [Public]
@@ -4342,6 +4391,16 @@ components:
         alternates: { $ref: "#/components/schemas/Alternates" }
         path: { type: string, nullable: true }
 
+    PublicSearchResult:
+      type: object
+      properties:
+        type: { type: string, enum: [page, project, service, call, member, technology] }
+        id: { type: integer }
+        title: { type: string }
+        excerpt: { type: string, description: Plain text around the first match. }
+        path: { type: string, nullable: true, example: /proyectos/mi-proyecto }
+        score: { type: number, description: Higher is a better match. Only comparable within one response. }
+
     PublicTechnology:
       type: object
       properties: