> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Search builders by name or code

> Returns builder metadata rows matching the query. Matches against `name` and `builder_code` (the `0x` prefix is optional). Results are sorted alphabetically by name and paginated.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/builders/search
openapi: 3.1.0
info:
  title: Polymarket API
  description: >-
    RESTful API for querying Polymarket prediction markets data including
    events, markets, traders, holders, and real-time metrics
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.struct.to/v1
security: []
paths:
  /polymarket/builders/search:
    get:
      tags:
        - Builders
      summary: Search builders by name or code
      description: >-
        Returns builder metadata rows matching the query. Matches against `name`
        and `builder_code` (the `0x` prefix is optional). Results are sorted
        alphabetically by name and paginated.
      operationId: search_builders
      parameters:
        - name: q
          in: query
          description: Search query (min 2 characters).
          required: true
          schema:
            type: string
        - name: limit
          in: query
          description: Max results per page (default 10, max 50).
          required: false
          schema:
            type: integer
            format: int64
        - name: offset
          in: query
          description: >-
            Offset for pagination (default 0). Takes precedence over
            `pagination_key`.
          required: false
          schema:
            type: integer
            format: int64
        - name: pagination_key
          in: query
          description: Opaque cursor from a previous response.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Matching builder metadata rows.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BuilderMetadata'
        '400':
          description: Bad request — `q` is missing or shorter than 2 characters.
components:
  schemas:
    BuilderMetadata:
      type: object
      description: |-
        One row of `polymarket_builder_metadata`. Includes `builder_code` since
        it's used as the keying field on the standalone metadata endpoints.
      required:
        - builder_code
        - name
      properties:
        builder_code:
          type: string
        name:
          type: string
        website:
          type:
            - string
            - 'null'
        twitter:
          type:
            - string
            - 'null'
        icon_url:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'

````