Field Intel API

The shelf, in JSON.

Push in-store observations from your field reps straight into the platform, reconcile them against online prices, and feed everything downstream — no bespoke pipeline, no CSV wrangling.

Get API keys View endpoints

Endpoints

POST

/v1/field-intel/observations

Ingest an in-store observation from a field rep

GET

/v1/field-intel/observations

List observations with filters by store, agent, SKU, date

GET

/v1/field-intel/price-gaps

Reconciled discrepancies between online and in-store prices

Example request

curl https://api.prizeskout.qa/v1/field-intel/observations \
  -H "Authorization: Bearer sk_live_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "store": "carrefour_lusail",
    "product_id": "sku_galaxy_buds_2_pro",
    "price": 445.00,
    "condition": "on_endcap",
    "promo_detail": "Buy 2 save 10%",
    "agent_id": "agent_042"
  }'

200 OK · application/json

{
  "id": "obs_01HX9P2K3M7QZ8Y4N6W5B1E2F0",
  "reconciled": true,
  "online_price": 449.00,
  "gap": -4.00,
  "direction": "below_online"
}

What you get

Structured observation schema: store, SKU, price, promo, condition, timestamp, photo URL

Automatic reconciliation against your latest online prices for the same SKU

Price-gap detection with direction and magnitude

Agent-level activity rollups for team management

Photo attachments stored securely and returned with signed URLs

Works with any mobile tool — our SDKs wrap the REST API for Android and iOS

Common integrations

Field ops app

Build your own field-rep app and post observations straight to the API.

Price-gap alerts

Fire webhooks when in-store prices diverge from online by more than a threshold.

Rep performance

Pull agent activity rollups into your HR and performance systems.