Improved
Product Reviews Schema Update — v2 Migration
3 days ago by ReadMe API
Product Reviews Schema Update — v2 Migration
We've updated the Product Reviews signal schema as part of the v2 migration. This update brings structural improvements and a significant increase in data coverage.
Schema Changes
New fields added:
| Field | Type | Description |
|---|---|---|
batch_id | string | Unique identifier for the delivery batch |
signal_name | string | Standardized signal name |
association | string | Entity association type |
detected_at | datetime | Timestamp when the signal was detected |
headline | string | Human-readable signal headline |
Fields removed:
| Field | Notes |
|---|---|
insight | Replaced by headline — provides a cleaner, more actionable summary |
relevance_score | Deprecated in v2 schema |
Record Count Increase
The v2 migration includes a +20% increase in record count due to expanded data source coverage and improved entity matching.
Migration Notes
- All v2 fields follow the standardized signal schema documented in Schema Reference
- The
headlinefield replacesinsightwith a more concise, actionable format - No breaking changes to existing integration patterns — new fields are additive (except for the two removed fields noted above)