Local Competitor Service Page Snapshot

Capture source-backed competitor service-page positioning, geography, proof, offer, CTA, review, and media evidence.

What it does

• Extracts service and location mentions from visible text.
• Detects quantified proof, credentials, customer proof, and review schema.
• Captures offer language and conversion links.
• Counts media and review-related signals.
• Optionally compares proof and CTA coverage with an owned page processed by the same logic.

Input

• competitorUrls, startUrls, or htmlInputs.
• targetServices and targetLocations.
• extractOffers and optional compareToOwnUrl.
• maxCompetitors, maxPagesPerCompetitor, maxPages, and maxDepth.
• maxChargeUsd for an estimated PPE spend ceiling.

Important behavior

This actor analyzes public HTML and supplied HTML evidence. It does not create image files. If captureScreenshots is true, the dataset explains that screenshot capture is unavailable so the result cannot be mistaken for a captured image.

Dataset output

Each dataset item is one JSON object. The schema includes:

• competitor domain and URL.
• service and location mentions.
• proof and review signals.
• offer and CTA text.
• media count.
• comparison gaps and positioning summary.

The actor also writes a Markdown summary, CSV records, JSON issues, evidence excerpts, and run metadata to key-value storage. Raw HTML is excluded unless includeRawSnapshots is enabled.

Pricing and charge safety

This actor uses pay per event with Apify platform-usage pass-through disabled. Charges are accepted before paid dataset or report output. maxChargeUsd stops the run before the next event would exceed the configured amount, including when the limit is zero.

Event	Price
actor-start	$0.03500
competitor-page-analyzed	$0.01150
competitor-evidence-record-extracted	$0.00650
opportunity-signal-emitted	$0.01150
executive-report-generated	$0.40000

Example input

{
  "htmlInputs": [
    {
      "sourceUrl": "https://competitor.example/nashville-roofing",
      "html": "<h1>Nashville Roof Repair</h1><p>Licensed and insured with 20+ years of service.</p><p>Free estimate this week.</p><a href=\"/quote\">Get a quote</a><blockquote>Excellent emergency service</blockquote><img src=\"crew.jpg\" alt=\"Roofing crew\">"
    }
  ],
  "targetServices": [
    "roof repair"
  ],
  "targetLocations": [
    "Nashville"
  ],
  "extractOffers": true,
  "maxCompetitors": 1,
  "maxPagesPerCompetitor": 1,
  "maxChargeUsd": 35
}

Result quality

• Public URL fetching rejects localhost and private IPv4 targets.
• Domain allowlists, timeouts, request delays, crawl depth, and actor-specific limits are enforced.
• Missing or blocked source evidence produces an explicit diagnostic instead of invented values.
• Every dataset row follows the declared dataset schema.
• Reports include the evidence reference and recommended next action for each finding.

Responsible use

Only process public pages or content you are authorized to analyze. Respect site terms, robots policies, rate limits, privacy obligations, and applicable law.