Trustpilot Product Reviews API — Product Reviews

naftiko: 1.0.0-alpha2
info:
  label: Trustpilot Product Reviews API — Product Reviews
  description: 'Trustpilot Product Reviews API — Product Reviews. 4 operations. Lead operation: Get Product Reviews Summary.
    Self-contained Naftiko capability covering one Trustpilot business surface.'
  tags:
  - Trustpilot
  - Product Reviews
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TRUSTPILOT_API_KEY: TRUSTPILOT_API_KEY
capability:
  consumes:
  - type: http
    namespace: product-reviews-product-reviews
    baseUri: https://api.trustpilot.com
    description: Trustpilot Product Reviews API — Product Reviews business capability. Self-contained, no shared references.
    resources:
    - name: v1-product-reviews-business-units-businessUnitId
      path: /v1/product-reviews/business-units/{businessUnitId}
      operations:
      - name: getproductreviewssummary
        method: GET
        description: Get Product Reviews Summary
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: businessUnitId
          in: path
          type: string
          required: true
        - name: apikey
          in: query
          type: string
          required: true
    - name: v1-product-reviews-business-units-businessUnitId-attribute-summaries
      path: /v1/product-reviews/business-units/{businessUnitId}/attribute-summaries
      operations:
      - name: getbatchattributeratingsummaries
        method: POST
        description: Get Batch Attribute Rating Summaries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: businessUnitId
          in: path
          type: string
          required: true
        - name: apikey
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-product-reviews-business-units-businessUnitId-batch-summaries
      path: /v1/product-reviews/business-units/{businessUnitId}/batch-summaries
      operations:
      - name: getbatchproductreviewssummaries
        method: POST
        description: Get Batch Product Reviews Summaries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: businessUnitId
          in: path
          type: string
          required: true
        - name: apikey
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-product-reviews-business-units-businessUnitId-reviews
      path: /v1/product-reviews/business-units/{businessUnitId}/reviews
      operations:
      - name: getproductreviews
        method: GET
        description: Get Product Reviews
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: businessUnitId
          in: path
          type: string
          required: true
        - name: page
          in: query
          type: integer
        - name: perPage
          in: query
          type: integer
        - name: apikey
          in: query
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.TRUSTPILOT_API_KEY}}'
  exposes:
  - type: rest
    namespace: product-reviews-product-reviews-rest
    port: 8080
    description: REST adapter for Trustpilot Product Reviews API — Product Reviews. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/v1/product-reviews/business-units/{businessunitid}
      name: v1-product-reviews-business-units-businessunitid
      description: REST surface for v1-product-reviews-business-units-businessUnitId.
      operations:
      - method: GET
        name: getproductreviewssummary
        description: Get Product Reviews Summary
        call: product-reviews-product-reviews.getproductreviewssummary
        with:
          businessUnitId: rest.businessUnitId
          apikey: rest.apikey
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/product-reviews/business-units/{businessunitid}/attribute-summaries
      name: v1-product-reviews-business-units-businessunitid-attribute-summaries
      description: REST surface for v1-product-reviews-business-units-businessUnitId-attribute-summaries.
      operations:
      - method: POST
        name: getbatchattributeratingsummaries
        description: Get Batch Attribute Rating Summaries
        call: product-reviews-product-reviews.getbatchattributeratingsummaries
        with:
          businessUnitId: rest.businessUnitId
          apikey: rest.apikey
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/product-reviews/business-units/{businessunitid}/batch-summaries
      name: v1-product-reviews-business-units-businessunitid-batch-summaries
      description: REST surface for v1-product-reviews-business-units-businessUnitId-batch-summaries.
      operations:
      - method: POST
        name: getbatchproductreviewssummaries
        description: Get Batch Product Reviews Summaries
        call: product-reviews-product-reviews.getbatchproductreviewssummaries
        with:
          businessUnitId: rest.businessUnitId
          apikey: rest.apikey
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/product-reviews/business-units/{businessunitid}/reviews
      name: v1-product-reviews-business-units-businessunitid-reviews
      description: REST surface for v1-product-reviews-business-units-businessUnitId-reviews.
      operations:
      - method: GET
        name: getproductreviews
        description: Get Product Reviews
        call: product-reviews-product-reviews.getproductreviews
        with:
          businessUnitId: rest.businessUnitId
          page: rest.page
          perPage: rest.perPage
          apikey: rest.apikey
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: product-reviews-product-reviews-mcp
    port: 9090
    transport: http
    description: MCP adapter for Trustpilot Product Reviews API — Product Reviews. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: get-product-reviews-summary
      description: Get Product Reviews Summary
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: product-reviews-product-reviews.getproductreviewssummary
      with:
        businessUnitId: tools.businessUnitId
        apikey: tools.apikey
      outputParameters:
      - type: object
        mapping: $.
    - name: get-batch-attribute-rating-summaries
      description: Get Batch Attribute Rating Summaries
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: product-reviews-product-reviews.getbatchattributeratingsummaries
      with:
        businessUnitId: tools.businessUnitId
        apikey: tools.apikey
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-batch-product-reviews-summaries
      description: Get Batch Product Reviews Summaries
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: product-reviews-product-reviews.getbatchproductreviewssummaries
      with:
        businessUnitId: tools.businessUnitId
        apikey: tools.apikey
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-product-reviews
      description: Get Product Reviews
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: product-reviews-product-reviews.getproductreviews
      with:
        businessUnitId: tools.businessUnitId
        page: tools.page
        perPage: tools.perPage
        apikey: tools.apikey
      outputParameters:
      - type: object
        mapping: $.