> ## Documentation Index > Fetch the complete documentation index at: https://docs.aitasker.co/llms.txt > Use this file to discover all available pages before exploring further. # Review Group Insights Trend Route > Coverage-derived sentiment and rating movement for one focused brand. Rating bands pool safely across review platforms; aspect benchmark shares remain platform-scoped on the separate matrix contract. ## OpenAPI ````yaml /openapi.json post /api/v1/brands/{brand_id}/brand-intelligence/review-group-insights/trend openapi: 3.1.0 info: title: AITasker version: 0.1.0 servers: [] security: [] paths: /api/v1/brands/{brand_id}/brand-intelligence/review-group-insights/trend: post: tags: - Brand Reviews - Brand Reviews summary: Review Group Insights Trend Route description: >- Coverage-derived sentiment and rating movement for one focused brand. Rating bands pool safely across review platforms; aspect benchmark shares remain platform-scoped on the separate matrix contract. operationId: >- review_group_insights_trend_route_api_v1_brands__brand_id__brand_intelligence_review_group_insights_trend_post parameters: - name: brand_id in: path required: true schema: type: string format: uuid title: Brand Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BrandReviewTrendRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/BrandReviewTrendResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: BrandReviewTrendRequest: properties: advertiser_id: type: string format: uuid title: Advertiser Id type: object required: - advertiser_id title: BrandReviewTrendRequest description: The group member selected for a coverage-aware trend. BrandReviewTrendResponse: properties: generated_at: type: string format: date-time title: Generated At advertiser_id: type: string format: uuid title: Advertiser Id brand_name: type: string title: Brand Name coverage: $ref: '#/components/schemas/ReviewTrendCoverage' buckets: items: $ref: '#/components/schemas/ReviewSentimentTrendBucket' type: array title: Buckets rating_movement: anyOf: - $ref: '#/components/schemas/ReviewRatingMovement' - type: 'null' type: object required: - generated_at - advertiser_id - brand_name - coverage title: BrandReviewTrendResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ReviewTrendCoverage: properties: status: type: string enum: - ok - single_bucket - no_overlap - no_data title: Status reason: type: string title: Reason default: '' bucket_size: anyOf: - type: string enum: - week - month - quarter - year - type: 'null' title: Bucket Size window_start: anyOf: - type: string format: date-time - type: 'null' title: Window Start window_end: anyOf: - type: string format: date-time - type: 'null' title: Window End review_count: type: integer minimum: 0 title: Review Count default: 0 depth_capped: type: boolean title: Depth Capped default: false leading_partial_bucket_start: anyOf: - type: string format: date-time - type: 'null' title: Leading Partial Bucket Start type: object required: - status title: ReviewTrendCoverage description: What the selected advertiser's stored sample can support. ReviewSentimentTrendBucket: properties: period_start: type: string format: date-time title: Period Start reviews: type: integer minimum: 0 title: Reviews reviews_examined: type: integer minimum: 0 title: Reviews Examined default: 0 positive: type: integer minimum: 0 title: Positive neutral: type: integer minimum: 0 title: Neutral negative: type: integer minimum: 0 title: Negative positive_pct: type: number maximum: 100 minimum: 0 title: Positive Pct neutral_pct: type: number maximum: 100 minimum: 0 title: Neutral Pct negative_pct: type: number maximum: 100 minimum: 0 title: Negative Pct average_rating: anyOf: - type: number maximum: 5 minimum: 1 - type: 'null' title: Average Rating is_partial: type: boolean title: Is Partial default: false included_in_trend: type: boolean title: Included In Trend default: true type: object required: - period_start - reviews - positive - neutral - negative - positive_pct - neutral_pct - negative_pct title: ReviewSentimentTrendBucket description: One calendar bucket in the selected advertiser's measured sample. ReviewRatingMovement: properties: previous_period_start: type: string format: date-time title: Previous Period Start current_period_start: type: string format: date-time title: Current Period Start previous_average_rating: type: number maximum: 5 minimum: 1 title: Previous Average Rating current_average_rating: type: number maximum: 5 minimum: 1 title: Current Average Rating previous_reviews_examined: type: integer minimum: 0 title: Previous Reviews Examined default: 0 current_reviews_examined: type: integer minimum: 0 title: Current Reviews Examined default: 0 observed_rating_delta: type: number title: Observed Rating Delta drivers: items: $ref: '#/components/schemas/ReviewRatingMovementDriver' type: array title: Drivers basis_notice: type: string title: Basis Notice default: >- Directional drivers may overlap because one review can mention several aspects; their scores do not add up to the observed rating change. type: object required: - previous_period_start - current_period_start - previous_average_rating - current_average_rating - observed_rating_delta title: ReviewRatingMovement description: Observed rating change plus ranked directional aspect drivers. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ReviewRatingMovementDriver: properties: aspect: type: string title: Aspect aspect_label: type: string title: Aspect Label previous_mentions: type: integer minimum: 0 title: Previous Mentions current_mentions: type: integer minimum: 0 title: Current Mentions previous_share_pct: type: number maximum: 100 minimum: 0 title: Previous Share Pct current_share_pct: type: number maximum: 100 minimum: 0 title: Current Share Pct share_change_pp: type: number title: Share Change Pp mean_rating: type: number maximum: 5 minimum: 1 title: Mean Rating driver_score: type: number title: Driver Score type: object required: - aspect - aspect_label - previous_mentions - current_mentions - previous_share_pct - current_share_pct - share_change_pp - mean_rating - driver_score title: ReviewRatingMovementDriver description: A directional, deliberately non-additive aspect movement signal. securitySchemes: HTTPBearer: type: http scheme: bearer ````