docs / enrich-store

Online Store Intelligence API

base /enrich-store/v13 endpoints

post/enrich-store/v1/store_lookup8 credits

store domain → platform verdict + store metadata + tech-stack + catalog sample (price/discount/stock signals) + reputation (mode-scaled depth)

Parameter		Allowed / range	Description
store	required	—	Store domain or URL (e.g. allbirds.com or https://shop.example.com). A leading www. / scheme / path is accepted and normalized.
mode = basic	optional	basic · catalog · rich	Depth of the lookup. Default basic. catalog scales credits with max_items; rich adds reputation/SERP depth.
max_items = 250	optional	1–1000	catalog mode only: walk store pages until this many products are sampled (hard-capped at 1000; for a FULL product harvest use the shopify engine directly — this is enrichment, not bulk export).
include_marketplace = false	optional	—	rich mode only: also probe Amazon/Etsy presence for the brand (OPTIONAL — false-match risk; every hit carries a confidence score, none is asserted as definitive).

Try in playground →

post/enrich-store/v1/platform_detect2 credits

Parameter		Allowed / range	Description
store	required	—	Store domain or URL (e.g. allbirds.com or https://shop.example.com). A leading www. / scheme / path is accepted and normalized.

Try in playground →

post/enrich-store/v1/batch20 credits

look up to 5 stores in one call (basic mode, cache-first, per-store ok/error)

Parameter		Allowed / range	Description
stores	required	—	Up to 5 store domains (array or comma-separated). Each is looked up in basic mode, cache-first, per-store ok/error.

Try in playground →

Example request · store_lookup

curl -X POST https://api.reefapi.com/enrich-store/v1/store_lookup \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"store":"definitely not a domain"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}