overlay: 1.0.0
info:
  title: API Evangelist enhancements for Sovrn Commerce Price Comparisons (Product Affiliate) API
  version: 1.0.0
extends: openapi/sovrn-price-comparisons-openapi.yml
actions:
- target: $.info
  description: Record API Evangelist provenance and the runtime facts Sovrn documents in prose but not
    in the spec.
  update:
    x-apievangelist-source: https://developer.sovrn.com/
    x-apievangelist-harvested: '2026-08-12'
    x-apievangelist-note: OpenAPI harvested verbatim from the definition Sovrn embeds in its own developer-center
      reference pages. Operations sharing this info/servers block were merged into one document; operation
      content is unmodified.
    x-authentication: Site API key as the `{site-api-key}` path segment
    x-authentication-artifact: authentication/sovrn-authentication.yml
    x-conventions-artifact: conventions/sovrn-conventions.yml
    x-error-catalog-artifact: errors/sovrn-problem-types.yml
- target: $.info
  description: Attach the published rate limit, which Sovrn documents on the reference page rather than
    in the spec.
  update:
    x-rate-limit: 100 requests per second, per account
    x-rate-limit-docs: https://developer.sovrn.com/reference/product-affiliate-api
    x-rate-limit-artifact: rate-limits/sovrn-rate-limits.yml
- target: $.tags
  description: Declare a tag for this service; Sovrn's published definitions carry no tags at all.
  update:
  - name: price-comparisons
    description: Sovrn Commerce Price Comparisons (Product Affiliate) API operations.
- target: $.paths.*.*
  description: Tag every operation so the estate can be grouped; no operation in Sovrn's published definitions
    is tagged.
  update:
    tags:
    - price-comparisons