openapi: 3.2.0
info:
  title: PaidHandshake Exchange Search API
  version: 2.9.0
  description: Broad lawful paid public-web research and commercial-intelligence routing, verified data feeds, delegated machine payments and recurring watches for autonomous agents.
servers:
- url: https://paidhandshake.com
tags:
- name: Search
paths:
  /api/v1/search:
    post:
      operationId: searchMatches
      summary: Search and rank current matches
      responses:
        '200':
          description: Ranked result preview
        '429':
          description: Rate limited
      tags:
      - Search
  /api/v1/search/{search_id}:
    get:
      operationId: getSearch
      summary: Retrieve a prior search preview
      parameters:
      - name: search_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Search preview
      tags:
      - Search
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: One-time-issued phm_ machine API key. Store securely; PaidHandshake stores only a hash.