Findermaster Scraper

Scrape classified ads and business listings from FinderMaster.com. Extract titles, descriptions, categories, contact info, images, and listing URLs across 100+ countries, states, and cities.

Features

• Multi-level scraping: Country → State → City → Listings → Detail pages
• Flexible input: Provide direct URLs, or specify country/state/city to auto-build URLs
• Pagination support: Automatically follows paginated listing pages
• Detail extraction: Optionally scrape full listing details (title, description, contact, images, etc.)
• Anti-bot protection: Stealth mode with fingerprinting, session rotation, and resource blocking
• Kill-switch: Graceful timeout handling for Apify platform limits

Input Configuration

Field	Type	Default	Description
startUrls	Array	[]	Direct URLs to scrape (auto-detects URL type)
country	String	-	Country code: usa, canada, australia, india, united-kingdom, etc.
state	String	-	State name (requires country), e.g. california, new-york
city	String	-	City name, e.g. anaheim, los-angeles
category	String	-	Category filter (reserved for future use)
maxItems	Number	100	Maximum number of listings to scrape
maxPages	Number	10	Maximum number of pagination pages per listing source
scrapeDetails	Boolean	true	Whether to visit individual listing detail pages
maxConcurrency	Number	5	Maximum concurrent browser pages
proxyConfiguration	Object	-	Apify proxy settings
debugMode	Boolean	false	Enable verbose logging

Example Input

Scrape listings from a specific city

{
    "city": "anaheim",
    "maxItems": 50,
    "scrapeDetails": true
}

Scrape all listings from a US state

{
    "country": "usa",
    "state": "california",
    "maxItems": 200,
    "maxPages": 5
}

Scrape from direct URLs

{
    "startUrls": [
        { "url": "https://anaheim.findermaster.com" },
        { "url": "https://www.findermaster.com/services/home-services/spencer-air-conditioning-&-heating_i378695" }
    ],
    "maxItems": 100
}

Quick scrape without detail pages

{
    "country": "usa",
    "state": "new-york",
    "scrapeDetails": false,
    "maxItems": 500
}

Output Format

Each scraped listing produces a JSON object:

{
    "listingId": "378695",
    "title": "Spencer Air Conditioning & Heating",
    "description": "Full service HVAC company...",
    "category": "FinderMaster > Home Services",
    "location": "Texas, USA",
    "date": "2024-01-15",
    "price": null,
    "phone": "+1-555-0123",
    "email": "info@example.com",
    "website": "https://example.com",
    "images": ["https://..."],
    "sourceUrl": "https://www.findermaster.com/services/home-services/spencer-air-conditioning-&-heating_i378695",
    "scrapedAt": "2025-02-21T14:00:00.000Z"
}

URL Structure

FinderMaster uses subdomain-based routing:

• Main site: https://www.findermaster.com
• Country: https://usa.findermaster.com
• State: https://usa.findermaster.com/state/california
• City: https://anaheim.findermaster.com
• Listing: https://www.findermaster.com/services/home-services/title_i123456
• Pagination: https://www.findermaster.com/search/sOrder,dt_pub_date/iOrderType,desc/city,Anaheim/iPage,2

Development

npm install
npm run dev    # Run with tsx (development)
npm run build  # Compile TypeScript
npm start      # Run compiled JS (production)

Deployment

Build and push to Apify using the included Dockerfile:

$apify push