SCOUTR

Finds businesses within a given radius of a start address, then visits each business’s website to extract a real contact email.

---

What it does

1. Geocode

   • Turns the start address into latitude/longitude.

2. Search nearby

   • Queries OpenStreetMap (Overpass) for nodes/ways/relations within the radius that match your keywords (by name plus category hints for common terms).

3. Collect details

   • Name and address from OSM tags.
   • Website and phone from contact:* / website tags.
   • If the website is missing, a light web search is used to guess the official site.

4. Fetch email from the website

   • Visits up to a few pages on the same domain, prioritizing contact/about pages.
   • Extracts emails from mailto: and visible text.
   • Filters out telemetry/template junk and prefers domain-matching or generic provider emails.

---

Input

Defined in input_schema.json.

Field	Type	Description
start_address	string	Start point (address)
range_meters	integer	Range in meters
keywords	array	Terms like restaurant, bakery, dentist
max_results	integer	Cap total businesses (0 = unlimited)
site_email_max_pages	integer	Pages to visit on each website
timeout_seconds	integer	Per-request read timeout
respect_robots_txt	boolean	Obey robots.txt if true

Example:

{
  "start_address": "Skippergata 22, 0154 Oslo, Norway",
  "range_meters": 1200,
  "keywords": ["restaurant", "bakery"],
  "max_results": 40,
  "site_email_max_pages": 3,
  "timeout_seconds": 30,
  "respect_robots_txt": false
}

---

Output

Each dataset item contains:

• name — Business name
• address — Postal address
• website — Official site if found
• phone — Phone when available
• email1..email3 — Emails discovered on the website (primary first)
• distance_m — Distance from the start point
• Plus context: start_address, range_meters, keywords, lat, lon.

---

Notes

• Overpass occasionally returns items just outside the radius; a final haversine cutoff is applied with a small buffer.
• Keyword-to-category hints are included for common types; extend OSM_CATEGORY_HINTS to add more.
• Keep site_email_max_pages modest to avoid crawling entire sites.

---

Disclaimer & License

This Apify Actor is provided "as is", without warranty of any kind — express or implied — including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. Use it, modify it, break it, or improve it — but you do so at your own risk.

© 2025 SLSH. All rights reserved. Copying or modifying the source code is prohibited.