overlay: 1.0.0
info:
  title: API Evangelist enhancements for Diffbot Web Search
  version: 1.0.0
extends: openapi/_original/diffbot-web-search-openapi.json
x-generated: '2026-09-06'
x-method: generated
x-source: Generated from openapi/_original/diffbot-web-search-openapi.json (3.0.0) plus the measured artifacts
  in this repository. Does not mutate the original contract.
actions:
- target: $.info
  description: Record where this contract was harvested from and what it is worth to an agent.
  update:
    x-apis-io-source: https://www.diffbot.com/openapi/web-search.json
    x-apis-io-harvested: '2026-09-06'
    x-apis-io-provider: diffbot
    x-apis-io-docs: https://www.diffbot.com/docs/web-search/
- target: $
  description: 'Attach the runtime semantics this contract does not state: error envelope, rate-limit
    signalling, idempotency and reversibility, all measured from Diffbot''s own documentation.'
  update:
    x-error-envelope:
      format: proprietary
      rfc9457: false
      shape: '{"errorCode": <int>, "error": "<message>"}'
      catalog: errors/diffbot-error-codes.yml
      warning: errorCode is not always the HTTP status; read the body.
    x-rate-limit-signalling:
      headers_returned: []
      retry_after: false
      status_on_exhaustion:
      - 429
      - 500
      catalog: rate-limits/diffbot-rate-limits.yml
    x-idempotency:
      coverage: none
      header: null
      note: No replay protection documented on any mutating operation.
    x-conventions: conventions/diffbot-conventions.yml
- target: $.components.securitySchemes
  description: 'Flag the auth divergence: this is the only Diffbot surface that does not take ?token=.'
  update:
    x-auth-divergence:
      this_surface: 'Authorization: Bearer <token>'
      every_other_diffbot_surface: ?token=<token> query parameter
      note: An agent generalising the query parameter across the estate will 401 here.