API Documentation
Nudge API
Access all your pricing intelligence data via REST API. Included on every plan, no surcharge.
Contents
All requests must be made over HTTPS. A maximum of 1,000 records are returned per request.
Base URL: https://api.thenudge.io/v1
Authentication
Send your API key as an Authorization header with every request. Find your key in Account Settings.
Authorization: Bearer YOUR_API_KEY
Products
Manage your product catalogue.
GET/products
Lists all products in your account.
curl https://api.thenudge.io/v1/products \
-H "Authorization: Bearer YOUR_API_KEY"
POST/products
Adds a new product and starts monitoring it.
{"name":"Nike Air Max 270","sku":"NKE-AM270-42","url":"https://yourstore.com/...","currency":"EUR","your_price":129.99}
Prices
Access competitor pricing data.
GET/prices/{product_id}
Returns all competitor prices for a product.
Alerts
Query MAP violations.
GET/alerts
Lists recent alerts. Unread shown first.
{"alerts":[{"id":"alt_01","type":"map_violation","retailer":"example.de","your_floor":89.99,"listed_price":79.99,"detected_at":"2026-06-16T09:14:22Z"}]}
Recommendations
Query AI-powered price recommendations.
GET/recommendations
Returns recommendations sorted by confidence score.
{"recommendations":[{"product_id":"prd_01","current_price":129.99,"suggested_price":126.99,"estimated_conversion_uplift":0.09,"confidence":0.87}]}
Rate limit: 60 req/min on Starter, 600 req/min on Growth, Scale and Enterprise.