Skip to main content
GET
Returns aggregated, anonymized regional crop pricing combining two sources:
  • 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.
Per-crop rows are returned only when the combined sample size is at least 5 distinct farms, to preserve contributor privacy. Crops below the threshold are silently filtered out.

Authentication

Requires a key with the market:read scope. See Authentication.

Query parameters

country
string
required
Country to aggregate over. Match the format used in the dashboard (e.g. Egypt, Spain, Morocco).
cropName
string
Optional. Filter to a single crop name (matches both userLocalPrices.cropName and crops.cropType).

Response

data
array
Per-crop aggregated price rows that meet the privacy threshold.
meta
object

Errors

StatusWhen
400 VALIDATION_ERRORcountry query parameter is missing
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks market:read scope
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error

Privacy

Rows are returned only when at least 5 distinct farms contribute to a crop. This applies after merging user-reported and sales data — a crop with 3 user reports plus 2 sales rows clears the threshold, but a crop with only 4 of either does not. No individual farm identifier is ever exposed.