- Overview
- Platform setup and administration
- Platform setup and administration
- Platform architecture
- Data Bridge onboarding overview
- Connecting a Peak-managed data lake
- Connecting a customer-managed data lake
- Creating an AWS IAM role for Data Bridge
- Connecting a Snowflake data warehouse
- Connecting a Redshift data warehouse (public connectivity)
- Connecting a Redshift data warehouse (private connectivity)
- Reauthorizing a Snowflake OAuth connection
- Using Snowflake with Peak
- SQL Explorer overview
- Roles and permissions
- User management
- Inventory management solution
- Commercial pricing solution
- Merchandising solution
Supply Chain & Retail Solutions user guide
The Competitor prices dataset contains observed competitor pricing per product and region over time. It gives the commercial pricing solution market context — letting it factor in how competitors are pricing the same products when generating pricing recommendations.
This dataset is required for application deployment and pricing insights analysis.
→ For the canonical technical schema (data types, validation rules, request/response examples), see Competitor Price in the API Guide.
Purpose
The commercial pricing solution uses the Competitor prices dataset to:
- Benchmark recommended prices against observed competitor pricing
- Account for competitive positioning in pricing recommendations
- Identify markets where our pricing is meaningfully out of line with competitors
- Support analysis of how competitor pricing changes over time
Without competitor pricing data, recommendations are made in isolation from the broader market context.
Required fields
About the Nullable column: every field below must appear in your data. Nullable: Yes means the field can be sent as null (or left blank in your source) when no value is available; Nullable: No means a non-null value is required for every row.
| Field | Description | Type | Nullable |
|---|---|---|---|
product_id | Unique identifier for each product. Used to join product metadata to the table. | string | No |
region_id | Unique identifier of the region. Used as a model feature, since competitive pricing varies by region. | string | No |
updated_at | Timestamp when the record was last updated. Successive observations of the same product/region combination are stored as new rows. | timestamp_tz | Yes |
competitor_price | Observed competitor price for this product in this region at the recorded time. | float | Yes |
Usage notes
- All referenced identifiers (
product_id,region_id) must exist in their corresponding datasets. - Submit observed market prices, not estimates — the model treats this as ground truth on competitive positioning.
- Successive observations of the same product and region are appended with new
updated_atvalues, preserving the full history of competitive movement over time. - Historical depth improves the solution's ability to detect pricing trends and react to competitor moves.
- Frequency of updates depends on how often you can observe competitor prices reliably; more frequent updates keep the model's competitive context current.
Why this dataset matters
The Competitor prices dataset is what connects the commercial pricing solution to the broader market. Without it, pricing recommendations only reflect internal cost and demand signals — missing the competitive pressure that often drives whether a quote is won or lost.