PriceLens API
Prices, history and offers for the stores we track, as JSON. For Enterprise workspaces.
Authentication
Create a key in Business → API. Send it as a bearer token or in the X-API-Key header.
curl -H "Authorization: Bearer pl_live_..." \ "https://pricelens.store/api/v1/partner/search?q=iphone%2015"
Endpoints
| GET | Scope | |
|---|---|---|
| /search?q={text} | market:read | Find products by name; returns the ids used below. |
| /products/{id}/market?days=90 | market:read | Current offers per store, median, price history, availability for one product. |
| /market/stats?brand={brand} | market:read | Price statistics across a brand or category. |
| /events?type={type}&since={date} | events:read | Your workspace’s own competitor events (price drops, undercuts, MAP violations). |
| /whoami | — | Confirms the key and shows its scopes and daily limit. |
Base URL: https://pricelens.store/api/v1/partner
Limits
Each key has a daily call limit set by the plan. Every response carries X-RateLimit-Limit and X-RateLimit-Remaining; past the limit the API answers 429 until 00:00 UTC.
Conventions
Responses use snake_case. A null field means we have no observation, never zero. Prices are in EGP. Identifiers: use the id or slug from search, or a GTIN, EAN, UPC or MPN.