Skip to main content
PrizeSkout
Pricing Recommendations API

Decide the right price. Cite the evidence.

Fetch a margin-aware recommendation for any SKU and channel set. Each recommendation ships with the expected P&L delta, a confidence score, and the signals that drove the decision — so your systems and humans can audit every move.

Get API keys View endpoints
Endpoints
POST
/v1/pricing/recommendations
Create a recommendation for a SKU on one or more channels
GET
/v1/pricing/recommendations/:id
Retrieve a single recommendation with signal attribution
GET
/v1/pricing/recommendations
List recommendations, filter by product, channel, or confidence
POST
/v1/pricing/decisions
Log whether you accepted, adjusted, or rejected a recommendation
Example request
curl https://api.prizeskout.qa/v1/pricing/recommendations \
  -H "Authorization: Bearer sk_live_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "sku_galaxy_buds_2_pro",
    "channels": ["talabat", "carrefour"],
    "objective": "protect_margin"
  }'
200 OK · application/json
{
  "id": "rec_01HX9P2K3M7QZ8Y4N6W5B1E2F0",
  "product_id": "sku_galaxy_buds_2_pro",
  "recommended_price": 449.00,
  "confidence": 0.91,
  "reason": "carrefour_price_drop",
  "expected_impact": {
    "margin_delta_pct": -0.8,
    "units_delta_pct": 6.4,
    "net_monthly": 3820
  }
}
What you get
Expected margin delta, unit impact, and net monthly impact on every recommendation
Confidence score calibrated against historical outcomes
Signal attribution: which competitor, which channel, which event drove the call
Per-channel guardrails you define — floor prices, MAP rules, margin minima
Webhook events when a new recommendation fires or an existing one changes
Full decision log for compliance and post-hoc analysis
Common integrations
Dynamic repricer
Poll or subscribe to recommendations and push price changes directly to your commerce platform.
Merchandising review
Queue recommendations for category managers to approve with full evidence attached.
Audit & compliance
Stream decisions to your data warehouse for quarterly pricing governance reviews.