docs / enrich-local

Local Business Intelligence API

base /enrich-local/v12 endpoints

post/enrich-local/v1/business_lookup8 credits

name+location ‖ place_query → matched place (Google Maps) + multi-source review presence + website health + indexed presence + negative-news + legitimacy signal list, with an honest coverage_note + per-group provenance.

Parameter		Allowed / range	Description
name	optional	—	Business name to look up. Pair with `location` (or lat/lng) for accurate chain-branch matching. Provide this+location OR `place_query`.
location	optional	—	City / neighborhood / address the business is in. Disambiguates same-named branches (used with `name`).
place_query	optional	—	Free-text place query (name + place hint in one string). Alternative to name+location.
lat	optional	-90–90	Latitude to geo-bias the match around — strongest branch disambiguator (pair with lng).
lng	optional	-180–180	Longitude to geo-bias the match around (pair with lat).
country	optional	—	ISO-3166 country hint (us, gb, tr…) — improves region-source routing (Yelp=US/CA, Tripadvisor=travel) and the coverage_note.
yelp_enc_biz_id	optional	—	Optional Yelp business identifier (the encrypted ID, not the URL slug). This is a shortcut: the engine already resolves a business name to its Yelp ID automatically — pass this only when you already have it and want to skip the lookup step.
include	optional	reviews · website · presence · news · legitimacy	Run ONLY these enrichment groups (cost control). Default: all. `place` (Google Maps) is always resolved — it is the anchor.
exclude	optional	reviews · website · presence · news · legitimacy	Drop these enrichment groups from the default set.

Try in playground →

post/enrich-local/v1/batch8 credits

enrich up to 10 businesses in one call (lead-list use-case; per-item ok/error, cache-first).

Parameter		Allowed / range	Description
businesses	required	—	Up to 10 businesses (each {name,location} / {place_query} / {name,lat,lng}). Lead-list enrichment; per-item ok/error, cache-first.
include	optional	reviews · website · presence · news · legitimacy	Run ONLY these enrichment groups (cost control). Default: all. `place` (Google Maps) is always resolved — it is the anchor.
exclude	optional	reviews · website · presence · news · legitimacy	Drop these enrichment groups from the default set.

Try in playground →

Example request · business_lookup

curl -X POST https://api.reefapi.com/enrich-local/v1/business_lookup \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"name":"Katz's Delicatessen","location":"Manhattan","lat":40.7223,"lng":-73.9874,"include":["website"]}'

Response shape

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