Brand Store Locator Scraper

🏪 Brand Store Locator Scraper

Give it any brand homepage URL — it automatically finds the store locator page, detects the platform, and extracts every retail location. No manual hunting for locator URLs. No configuration needed. Just brand URLs in, structured store data out.

Works across Storemapper, Locally.com, Stockist.co, custom HTML lists, and JavaScript-rendered locators via smart Playwright fallback.

✨ Features

• 🔍 Automatic Locator Discovery — Finds store locator pages from any brand homepage using nav link scanning, sitemap parsing, and common path probing (/store-locator, /find-a-store, /stockists, and more)
• 🔌 Built-in Service Adapters — Native support for Storemapper, Locally.com (both company_key and subdomain/company_id APIs), and Stockist.co. Calls their APIs directly for maximum speed
• 🎭 Playwright Fallback — When the locator is JavaScript-rendered, automatically escalates to a full browser with XHR interception, DOM re-detection, and search form simulation
• 🧹 Normalized Output — All records share a consistent schema regardless of source: name, address, city, state, country, postal code, geo coordinates, phone, website
• ⚡ HTTP-First Architecture — CheerioCrawler handles discovery and API extraction (fast, cheap). Playwright only runs when needed (2 concurrent browsers max)

🛠️ How It Works

1. Provide brand URLs — Homepages like https://www.untuckit.com or https://www.darntough.com
2. Automatic discovery — Scans nav links, sitemap.xml, and probes candidate paths to find the store locator page
3. Service detection — Identifies the platform (Storemapper, Locally, Stockist, HTML list, map, search form)
4. Extraction — Calls the service API directly or parses the HTML. Falls back to Playwright + XHR interception for JS-rendered locators
5. Get your data — Clean, normalized JSON with up to 15 fields per store location

🔌 Supported Locator Platforms

Platform	Method	Notes
🗺️ Storemapper	JSONP API	Detects via data-storemapper-id or script src
📍 Locally.com	Geo sweep API	Supports both company_key and company_id (subdomain API)
📦 Stockist.co	REST API	Extracts key from widget script URL
📋 HTML List	Cheerio parsing	Static <address> tags and store item containers
🌐 JS-rendered (any)	Playwright + XHR intercept	Scores JSON responses by field presence to find store arrays
🔎 Search Form	Playwright form simulation	Fills 14 global postal codes, collects XHR deltas per submission

⚙️ Input Parameters

Parameter	Type	Default	Description
startUrls	array	required	Brand homepage URLs to scrape
maxStoresPerBrand	integer	500	Maximum store records per brand. Set to 0 for unlimited
proxyConfiguration	object	—	Optional proxy settings

Input Example

{
    "startUrls": [
        { "url": "https://www.untuckit.com" },
        { "url": "https://www.darntough.com" },
        { "url": "https://www.hydroflask.com" }
    ],
    "maxStoresPerBrand": 500
}

📊 Output Example

Each store location is a normalized JSON record:

{
    "brandName": "darntough.com",
    "brandUrl": "https://www.darntough.com",
    "storeName": "REI - Soho Flagship",
    "address": "109 East Houston St",
    "city": "New York",
    "state": "NY",
    "country": "US",
    "postalCode": "10002",
    "latitude": 40.7237,
    "longitude": -73.9957,
    "phone": "(212) 505-3860",
    "website": "https://www.rei.com/stores/new-york-soho.html",
    "locatorService": "locally",
    "sourceUrl": "https://darntough.com/pages/find-a-store",
    "extractedAt": "2026-03-17T09:00:00.000Z"
}

📋 Output Fields

Field	Description
brandName	Brand domain (e.g. darntough.com)
brandUrl	Brand homepage URL
storeName	Store or retailer name
address	Street address
city	City
state	State or province
country	Country
postalCode	ZIP or postal code
latitude	Geo latitude
longitude	Geo longitude
phone	Phone number
email	Email address (when available)
website	Store-specific website or URL
locatorService	Source platform (storemapper, locally, stockist, html_list, xhr_intercept)
sourceUrl	URL of the store locator page
extractedAt	ISO 8601 extraction timestamp

💡 Use Cases

• Retail Intelligence — Map a competitor's physical footprint across regions and retail channels
• Location Data Enrichment — Build or refresh a database of brand stockists and authorized retailers
• Market Research — Identify which retail chains carry which brands and where
• Sales Prospecting — Find new distribution opportunities by seeing where similar brands are stocked
• Supply Chain Analysis — Track how a brand's retail presence changes over time

Start mapping the retail landscape with Brand Store Locator Scraper today! 🚀