MyHammer Contractor Scraper for German Leads

Find MyHammer contractors by German postal code and profession without manually browsing search pages.

The MyHammer Contractor Search Scraper extracts structured contractor directory results from MyHammer for a selected German ZIP code and a fixed job-title dropdown value such as Maler und Lackierer, Elektriker, Dachdecker, or Sanitärinstallateur. It is built for agencies, local-market analysts, construction suppliers, SaaS teams, and B2B researchers who need clean contractor profile data for German regional market research.

Use it to collect MyHammer search result records into Apify datasets and export them as JSON, CSV, Excel, or via API for downstream workflows.

Key Features

• Search MyHammer contractor results by German 5-digit postal code.
• Select a profession from the fixed MyHammer job-title dropdown values exposed in the Actor input schema.
• Extract contractor search result data from MyHammer Next.js page data.
• Capture company/display name, MyHammer profile URL, contractor ID, city/location text, ratings, review count, services, badges, snippets, descriptions, images when available, and raw source metadata.
• Handles result pagination with configurable maxPages and maxItems limits.
• Deduplicates contractors across pages before saving dataset records.
• Uses PlaywrightCrawler for browser-based extraction and supports Apify proxy configuration.
• Fails clearly if MyHammer serves a Cloudflare challenge or a page without contractor directory data, instead of fabricating output.
• Produces CSV/JSON-ready records for analysis, enrichment, CRM import preparation, or automation workflows.

How it Works

1. Enter a German postal code and choose a supported MyHammer job title from the dropdown.
2. Set optional limits such as maximum contractors, maximum pages, request delay, and proxy configuration.
3. Run the Actor on Apify and download the resulting dataset as JSON, CSV, Excel, or consume it through the Apify API.

Input Example

{
  "postalCode": "10115",
  "jobTitle": "Maler und Lackierer",
  "maxItems": 100,
  "maxPages": 10,
  "requestDelayMs": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Input Parameters

• postalCode — German 5-digit postal code, for example 10115.
• jobTitle — fixed dropdown/select value from the Actor input schema, for example Maler und Lackierer, Elektriker, Dachdecker, or Sanitärinstallateur. Free-form job titles are not supported.
• maxItems — maximum unique contractors to save. Default: 100. Allowed range: 1 to 1000.
• maxPages — maximum search result pages to crawl. Default: 10. Allowed range: 1 to 100.
• requestDelayMs — polite delay before each page navigation. Default: 1000. Allowed range: 0 to 30000.
• proxyConfiguration — Apify proxy settings. Residential proxies are recommended because MyHammer uses Cloudflare.

Output Sample (JSON format)

{
  "searchPostalCode": "10115",
  "searchJobTitle": "Maler und Lackierer",
  "searchUrl": "https://www.my-hammer.de/malerarbeiten-tapezieren/maler-lackierer-berufe/berlin",
  "pageNumber": 1,
  "positionOnPage": 1,
  "scrapedAt": "2026-06-04T14:22:34.613Z",
  "companyName": "GT. Maler & Trockenbau",
  "displayName": "GT. Maler & Trockenbau",
  "profileUrl": "https://www.my-hammer.de/auftragnehmer/gt-maler-trockenbau",
  "contractorId": "15184557",
  "locationText": "Zeuthen",
  "city": "Zeuthen",
  "postalCode": null,
  "distanceKm": null,
  "ratingValue": 4.7,
  "reviewCount": 9,
  "trades": [],
  "services": [
    "Innenausbau und Sanierung"
  ],
  "badges": [
    "VALID_ID",
    "VERIFIED_LICENSE"
  ],
  "snippet": "Alles gut!",
  "shortDescription": "GT. Maler-Trockenbau\n20 Jahre Erfahrung in der Branche\nLegen Sie Farbe in Ihr Leben und machen Sie Ihr Zuhause.",
  "imageUrl": "https://www.my-hammer.de/images/sp/thumbnail_small/b4e93cd0-d01e-4e4e-b97d-f41c4b6ab8ff.jpg",
  "logoUrl": "https://www.my-hammer.de/images/sp/thumbnail_small/b4e93cd0-d01e-4e4e-b97d-f41c4b6ab8ff.jpg",
  "responseTime": null,
  "availability": null,
  "rawMetadata": {
    "id": 15184557,
    "slug": "gt-maler-trockenbau",
    "name": "GT. Maler & Trockenbau",
    "score": 9.3,
    "ratings": 9,
    "isNew": false,
    "review": {
      "text": "Alles gut!",
      "createdAt": "2026-03-19T17:52:12+00:00",
      "serviceName": "Innenausbau und Sanierung",
      "picture": null
    },
    "badges": [],
    "verifications": [
      "VALID_ID",
      "VERIFIED_LICENSE"
    ],
    "isFeatured": true,
    "avatar": "https://www.my-hammer.de/images/sp/thumbnail_small/b4e93cd0-d01e-4e4e-b97d-f41c4b6ab8ff.jpg",
    "bio": "GT. Maler-Trockenbau\n20 Jahre Erfahrung in der Branche\nLegen Sie Farbe in Ihr Leben und machen Sie Ihr Zuhause.",
    "contentCluster": {
      "__typename": "ContentCluster",
      "slug": "bauen-renovieren"
    },
    "sponsoredPlacementId": 115819,
    "primaryLocation": "Zeuthen"
  }
}

AI & LLM Integration (RAG-Ready)

The Actor returns structured contractor records that can be used in AI and automation workflows:

• Feed companyName, city, services, badges, snippet, shortDescription, ratingValue, and reviewCount into lead scoring or market segmentation models.
• Store contractor profiles in a vector database for retrieval-augmented generation (RAG), for example to answer questions about local service-provider density by profession and region.
• Use the dataset as a source for Model Context Protocol (MCP) tools or internal analytics assistants.
• Summarize contractor descriptions and recent review snippets for regional market research.
• Compare repeated runs over the same postal code and job title to monitor changes in MyHammer search results.

Do not use the output to imply verified credentials beyond the badge or verification strings returned by MyHammer in the public page data.

Target Users

• B2B sales and marketing teams researching German home-service and contractor markets.
• Construction suppliers and SaaS vendors looking for regional contractor segments.
• Local SEO and agency teams analyzing service-provider visibility by profession and ZIP code.
• Market researchers comparing contractor density, reviews, and profile quality across German locations.
• Data teams building enrichment, scoring, or monitoring pipelines around public contractor directory data.

Use Cases

• Build a CSV list of MyHammer contractor profiles for a selected German postal code and trade.
• Compare which contractors appear for the same trade in different German cities or postal codes.
• Monitor rating and review-count changes in local contractor categories.
• Prepare public directory profile data for manual outreach research or CRM enrichment workflows.
• Analyze competitive coverage for professions such as painters, electricians, roofers, plumbers, and landscapers.

Limitations & Compliance-Friendly Notes

• The Actor extracts public MyHammer directory result data available in the loaded page data.
• It does not claim to extract private contact details, private customer data, hidden emails, or phone numbers.
• Free-form job title search is not supported; use the fixed dropdown values provided in the input schema.
• MyHammer uses Cloudflare. Residential proxies are recommended, and some runs may fail if the site serves a challenge page.
• Badge and verification strings are passed through from MyHammer data. The Actor does not independently verify contractor licenses, identity, or qualifications.
• Results can vary by time, location, MyHammer ranking, pagination, and platform changes.
• Users are responsible for complying with applicable laws, platform terms, and privacy obligations when using extracted data.

Troubleshooting

• No contractor records found: Verify that postalCode is a valid German 5-digit ZIP code and that jobTitle is one of the fixed dropdown values in the input schema.
• Cloudflare or challenge-page error: Run with Apify Proxy, preferably a residential proxy group, and retry with conservative limits.
• Unexpectedly low result count: MyHammer rankings, availability, pagination, and location matching can change over time. Increase maxPages or compare another postal code/job-title pair.
• Free-form job title rejected: The Actor intentionally accepts only supported MyHammer profession dropdown values to keep URLs deterministic.

Review Checklist Before Store Publish

• README, input schema, dataset schema, output schema, and deployment notes are synchronized.
• Example input uses a German 5-digit postal code and a fixed job-title dropdown value.
• Example output fields match the real dataset records emitted by the Actor.
• Local pnpm test, pnpm build, and apify run have passed.
• Apify Store PPE is configured as per-contractor-extracted at $0.004 per contractor record.
• Pass platform usage costs to users is enabled.
• Final apify push and Store publish are performed only after Peter's explicit approval.