Market Intelligence
Get regional prices
Anonymized regional crop prices aggregated from user reports and sales.
GET
- User-reported local prices — what farms in the region say they’re paying or selling for.
- Recorded crop sales — actual sale transactions on the platform.
Authentication
Requires a key with themarket:read scope. See Authentication.
Query parameters
Country to aggregate over. Match the format used in the dashboard (e.g.
Egypt, Spain, Morocco).Optional. Filter to a single crop name (matches both
userLocalPrices.cropName and crops.cropType).Response
Per-crop aggregated price rows that meet the privacy threshold.
Errors
| Status | When |
|---|---|
400 VALIDATION_ERROR | country query parameter is missing |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks market:read scope |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |