What's in this dataset
Know which national chains surround a site, which tenants it is missing, and where a brand is likely to expand next. A weekly registry of ~866,000 US chain store locations with 97 weeks of store-level history powers one-call site briefs, void analysis backtested against real openings (AUC 0.86), brand whitespace, co-tenancy lift, same-format competition, organic openings and closures, and metro under-retailed screens. Every count separates verified from carried stores, so a broken store-locator feed never masquerades as a closure.
Capabilities at a glance
GET /v1/site/brief— One-call site packet: storefront counts by sector at 1/3/5 mi, percentile-ranked metrics, nearest anchors, top tenants, tenant momentum, top voids. Point: lat+lon OR address.GET /v1/site/voids— Brands missing within 3 mi that the 200 most similar trade areas in other metros have, with backtested opening_rate_18m. Point: lat+lon OR address.GET /v1/site/nearby— Chain locations within miles (<=10) of a point, nearest first; filter by sector/subsector/brand_id.GET /v1/site/competition— Same-format stores around a site: own stores (cannibalization) and competitors. REQUIRED: brand_id.GET /v1/brands— Search/screen brands. Use q=<name> to resolve a tenant name to its brand_id (Wikidata QID) before any brand call.GET /v1/brands/{brand_id}/brief— Tenant packet: metrics with percentiles, state footprint, weekly trend, co-tenants, whitespace, caveats.GET /v1/brands/{brand_id}/whitespace— Trade areas where the brand is absent, ranked by void score (one per ~3-mi hex). state is a 2-digit FIPS code.GET /v1/brands/{brand_id}/cotenants— Brands over-represented within 400 m of this brand's stores, as lift.GET /v1/markets— Screen CBSAs on one metric (net openings, stores per 10k by sector, income_per_chain_store under-retailed index).GET /v1/markets/{cbsa}/brief— Metro packet: metrics + percentiles, sector mix, top brands, net-growth brands.GET /v1/changes— Organic openings/closures feed; filter by since, event, brand_id, state, cbsa.GET /v1/categories— Free. Sector/subsector taxonomy with current counts.GET /v1/methodology— Free. Registry rules, void calibration bands, percentile definitions, sources, known limits.
Example queries
What's the chain retail landscape around 4500 Legacy Dr, Frisco, TX?Which national tenants are missing from this shopping center site and should we target?How many competing dollar stores are within 5 miles of this Dollar General?Tell me about Chipotle — footprint, 52-week growth, co-tenants, and whitespaceWhere should Chick-fil-A expand next in Texas?Is the Denver metro over- or under-retailed for shopping formats?What chain stores opened or closed in the Dallas metro over the last month?Which tenants co-locate most often with Trader Joe's?Full reference
Reference documentation coming soon.
Skills powered by this dataset
No published skills tag this dataset yet — but every skill in the Hub can call it directly via MCP or REST.