{ "openapi": "3.0.1", "info": { "title": "Porch.com Contractor Scraper — Home Service Pro Leads", "description": "785,653 home-service pros from Porch.com: business name, trade, phone (99.7% fill), website, street address, lat/lon, rating, reviews, years in business, full services list, ZIP service area and cached state licence records. 131 trades, all 50 states. Filter by trade, state, city or rating.", "version": "0.1", "x-build-id": "sH52i4S4zHd3u0FG5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~porch-pro-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-porch-pro-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapersdelight~porch-pro-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-porch-pro-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapersdelight~porch-pro-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-porch-pro-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "trades": { "title": "Trades", "uniqueItems": true, "type": "array", "description": "Which Porch trades to pull. The number after each name is how many profiles that trade holds in the live directory, counted across all 785,653 sitemap URLs on 2026-08-12 — so you can size a run before you start it. Leave empty for every trade. Example: General Contractors (141,500) plus Electricians (60,430).", "items": { "type": "string", "enum": [ "general-contractors", "electricians", "plumbers", "handymen", "painters", "remodeling-contractors", "hvac-contractors", "roofers", "landscapers", "garage-door-specialists", "home-cleaners", "flooring-contractors", "pest-control-contractors", "locksmiths", "appliance-repair-services", "window-contractors", "real-estate-professionals", "carpet-cleaners", "tree-contractors", "home-inspectors", "movers", "home-builders", "concrete-contractors", "lawn-and-garden-services", "pool-and-spa-specialists", "fencing-contractors", "cabinet-makers", "glass-and-mirror-contractors", "interior-designers", "custom-furniture-builders", "garbage-removal-contractors", "asphalt-and-paving-contractors", "architects", "security-and-alarm-technicians", "property-managers", "metal-workers-and-welders", "gutter-specialists", "pressure-washing-contractors", "carpenters", "home-theater-contractors", "tile-contractors", "window-treatment-specialists", "excavation-contractors", "drywall-contractors", "chimney-sweepers", "restoration-specialists", "window-cleaners", "appliance-installation-specialists", "door-contractors", "decking-contractors", "phone-and-internet-specialists", "masons", "septic-tank-contractors", "insulation-contractors", "countertop-contractors", "siding-contractors", "upholstering-specialists", "landscape-architects-and-designers", "furniture-refinishing-and-repairpersons", "structural-engineers", "home-furnishings-retailers", "dryer-vent-cleaning-specialists", "lawn-irrigation-specialists", "kitchen-and-bath-remodelers", "carpet-installers", "repair-specialists", "surveyors", "solar-energy-contractors", "home-organizers", "awning-contractors", "waterproofing-contractors", "mold-removal-specialists", "water-suppliers", "design-and-build-firms", "lawn-mower-and-power-tool-repairpersons", "outdoor-storage-building-contractors", "decorators", "well-contractors", "home-automation-specialists", "animal-removal-specialists", "water-treatment-specialists", "plastering-contractors", "demolition-contractors", "generator-specialists", "hardscapers", "bathtub-refinishing-and-liner-specialists", "gutter-cleaning-contractors", "stucco-contractors", "bathroom-fixture-installers", "home-stagers", "lighting-consultants", "sewer-and-drain-contractors", "lawn-treatment-specialists", "asbestos-removal-specialists", "wallpaper-hangers", "driveway-gates-contractors", "cabinet-refacing-and-restoration-specialists", "play-set-construction-contractors", "energy-efficiency-auditors", "piano-tuners", "disabled-access-contractors", "heating-oil-suppliers", "framing-contractors", "tv-repair-services", "marble-contractors", "window-blind-cleaners", "stair-builders", "snow-removal-contractors", "firewood-suppliers", "real-estate-photographers", "civil-engineers", "helpers-with-trucks", "mold-inspectors", "kitchen-and-bath-designers", "fire-protection-contractors", "biohazard-remediators", "propane-suppliers", "radon-detection-and-reduction-specialists", "dock-building-and-repair-contractors", "builders-hardware-retailers", "lead-testing-and-removal-specialists", "childproofing-consultants", "lighting-installers", "pooper-scoopers", "green-building-contractors", "central-vacuum-cleaning-specialist", "soil-engineers", "decorative-hardware-retailers", "mortgage-lenders", "earthquake-retrofitting-specialists", "storm-shelter-contractors" ], "enumTitles": [ "General Contractors (141,500)", "Electricians (60,430)", "Plumbers (51,920)", "Handymen (36,368)", "Painters (35,777)", "Remodeling Contractors (34,510)", "HVAC Contractors (32,334)", "Roofers (31,465)", "Landscapers (27,891)", "Garage Door Specialists (17,777)", "Home Cleaners (16,432)", "Flooring Contractors (14,424)", "Pest Control Contractors (12,110)", "Locksmiths (11,056)", "Appliance Repair Services (10,771)", "Window Contractors (10,635)", "Real Estate Professionals (10,492)", "Carpet Cleaners (9,251)", "Tree Contractors (9,102)", "Home Inspectors (8,776)", "Movers (8,188)", "Home Builders (8,136)", "Concrete Contractors (7,710)", "Lawn and Garden Services (7,624)", "Pool and Spa Specialists (7,012)", "Fencing Contractors (6,733)", "Cabinet Makers (5,255)", "Glass and Mirror Contractors (4,550)", "Interior Designers (4,542)", "Custom Furniture Builders (4,494)", "Garbage Removal Contractors (4,385)", "Asphalt and Paving Contractors (4,133)", "Architects (3,976)", "Security and Alarm Technicians (3,798)", "Property Managers (3,746)", "Metal Workers and Welders (3,591)", "Gutter Specialists (3,511)", "Pressure Washing Contractors (3,449)", "Carpenters (3,302)", "Home Theater Contractors (3,073)", "Tile Contractors (3,073)", "Window Treatment Specialists (3,031)", "Excavation Contractors (3,027)", "Drywall Contractors (2,971)", "Chimney Sweepers (2,927)", "Restoration Specialists (2,923)", "Window Cleaners (2,882)", "Appliance Installation Specialists (2,871)", "Door Contractors (2,778)", "Decking Contractors (2,711)", "Phone and Internet Specialists (2,693)", "Masons (2,669)", "Septic Tank Contractors (2,507)", "Insulation Contractors (2,334)", "Countertop Contractors (2,125)", "Siding Contractors (2,094)", "Upholstering Specialists (2,085)", "Landscape Architects and Designers (2,068)", "Furniture Refinishing and Repairpersons (2,036)", "Structural Engineers (2,028)", "Home Furnishings Retailers (1,997)", "Dryer Vent Cleaning Specialists (1,925)", "Lawn Irrigation Specialists (1,895)", "Kitchen and Bath Remodelers (1,666)", "Carpet Installers (1,652)", "Repair Specialists (1,639)", "Surveyors (1,573)", "Solar Energy Contractors (1,545)", "Home Organizers (1,544)", "Awning Contractors (1,487)", "Waterproofing Contractors (1,384)", "Mold Removal Specialists (1,266)", "Water Suppliers (1,241)", "Design and Build Firms (1,226)", "Lawn Mower and Power Tool Repairpersons (1,192)", "Outdoor Storage Building Contractors (1,188)", "Decorators (1,173)", "Well Contractors (1,067)", "Home Automation Specialists (1,042)", "Animal Removal Specialists (1,038)", "Water Treatment Specialists (996)", "Plastering Contractors (933)", "Demolition Contractors (896)", "Generator Specialists (825)", "Hardscapers (783)", "Bathtub Refinishing and Liner Specialists (773)", "Gutter Cleaning Contractors (731)", "Stucco Contractors (688)", "Bathroom Fixture Installers (655)", "Home Stagers (639)", "Lighting Consultants (608)", "Sewer and Drain Contractors (584)", "Lawn Treatment Specialists (577)", "Asbestos Removal Specialists (573)", "Wallpaper Hangers (563)", "Driveway Gates Contractors (539)", "Cabinet Refacing and Restoration Specialists (533)", "Play Set Construction Contractors (514)", "Energy Efficiency Auditors (459)", "Piano Tuners (458)", "Disabled Access Contractors (439)", "Heating Oil Suppliers (435)", "Framing Contractors (430)", "TV Repair Services (425)", "Marble Contractors (423)", "Window Blind Cleaners (396)", "Stair Builders (361)", "Snow Removal Contractors (360)", "Firewood Suppliers (331)", "Real Estate Photographers (330)", "Civil Engineers (319)", "Helpers with Trucks (297)", "Mold Inspectors (282)", "Kitchen and Bath Designers (270)", "Fire Protection Contractors (264)", "Biohazard Remediators (252)", "Propane Suppliers (234)", "Radon Detection and Reduction Specialists (233)", "Dock Building and Repair Contractors (209)", "Builders Hardware Retailers (203)", "Lead Testing and Removal Specialists (177)", "Childproofing Consultants (146)", "Lighting Installers (135)", "Pooper Scoopers (135)", "Green Building Contractors (105)", "Central Vacuum Cleaning Specialist (76)", "Soil Engineers (69)", "Decorative Hardware Retailers (57)", "Mortgage Lenders (51)", "Earthquake Retrofitting Specialists (47)", "Storm Shelter Contractors (33)" ] } }, "states": { "title": "States", "uniqueItems": true, "type": "array", "description": "US states, DC and territories, each with its live profile count (counted across all 785,653 sitemap URLs on 2026-08-12). Leave empty for nationwide. Filtering here is free — the state is in the URL, so no page is ever fetched for a pro outside your selection.", "items": { "type": "string", "enum": [ "AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "GU", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MP", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VI", "VT", "WA", "WI", "WV", "WY" ], "enumTitles": [ "Alaska — 2,152", "Alabama — 10,645", "Arkansas — 5,956", "Arizona — 19,899", "California — 121,855", "Colorado — 18,917", "Connecticut — 7,971", "Washington DC — 1,049", "Delaware — 2,259", "Florida — 64,665", "Georgia — 24,796", "Guam — 3", "Hawaii — 2,614", "Iowa — 5,217", "Idaho — 4,798", "Illinois — 23,605", "Indiana — 14,232", "Kansas — 6,253", "Kentucky — 8,675", "Louisiana — 9,181", "Massachusetts — 14,690", "Maryland — 11,944", "Maine — 2,510", "Michigan — 17,526", "Minnesota — 10,349", "Missouri — 13,594", "Northern Mariana Islands — 1", "Mississippi — 4,613", "Montana — 2,770", "North Carolina — 30,450", "North Dakota — 1,361", "Nebraska — 4,645", "New Hampshire — 3,326", "New Jersey — 17,232", "New Mexico — 4,643", "Nevada — 8,500", "New York — 29,932", "Ohio — 26,662", "Oklahoma — 9,851", "Oregon — 11,027", "Pennsylvania — 23,272", "Puerto Rico — 55", "Rhode Island — 2,243", "South Carolina — 13,104", "South Dakota — 1,831", "Tennessee — 17,403", "Texas — 81,180", "Utah — 7,251", "Virginia — 19,878", "US Virgin Islands — 7", "Vermont — 1,205", "Washington — 24,310", "Wisconsin — 10,042", "West Virginia — 2,376", "Wyoming — 1,025" ] } }, "cities": { "title": "Cities (optional)", "type": "array", "description": "Porch city slugs — the city part of the profile URL. Porch publishes 20,197 city+state combinations, far too many for a dropdown, so this is a paste-in list: houston, los-angeles, san-antonio, new-york, west-sacramento. Spaces are converted for you, so \"West Sacramento\" also works. Biggest by profile count: houston 8,486 · los-angeles 6,498 · san-antonio 5,783 · chicago 5,230 · austin 4,997. Leave empty for every city in the selected states.", "items": { "type": "string" } }, "profileUrls": { "title": "Profile URLs — paste them here instead", "type": "array", "description": "Paste exact Porch profile URLs (https://pro.porch.com/{city}-{st}/{trade}/{business}/pp) to re-scrape or refresh a list you already have. This path skips the sitemap entirely, so it is the fastest way to run, and it overrides the trade / state / city filters. A URL that is not a Porch pro-profile URL stops the run with an error naming the bad one, rather than quietly returning nothing.", "items": { "type": "string" } }, "claimedOnly": { "title": "Only claimed listings", "type": "boolean", "description": "Keep only pros who have claimed and maintain their Porch listing (a live account rather than a directory stub Porch built itself). Measured 76.4% of profiles, so about 1.3 pages are fetched per row kept. Claimed pros carry a service list 97% of the time vs 0% for stubs, and a website 73% vs 41% — but a rating only 19% of the time vs 76%, so combining this with a rating floor gets expensive fast.", "default": false }, "withWebsiteOnly": { "title": "Only pros with a website", "type": "boolean", "description": "Keep only pros whose profile lists a company website (measured 65.4% of profiles). This is the field to filter on when you plan to enrich for e-mail, because Porch itself never publishes an e-mail address.", "default": false }, "minRating": { "title": "Minimum star rating", "enum": [ "0", "3", "3.5", "4", "4.5", "5" ], "type": "string", "description": "Drop pros rated below this. Only 32.1% of Porch profiles carry any rating at all and a floor drops every unrated pro, so 4.0+ keeps 24.6% of the directory and fetches 4.1 pages for every row you keep. Ratings also sit mostly on UNCLAIMED listings (76% of stubs vs 19% of claimed accounts), so combining 4.0+ with \"Only claimed listings\" keeps just 11.3% at 8.9 pages per row. \"Any rating\" keeps everyone.", "default": "0" }, "minReviewCount": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Drop pros with fewer aggregated reviews than this. Same caveat as the rating floor — the 67.9% of pros Porch shows no reviews for are dropped as well. 0 = keep everyone.", "default": 0 }, "minYearsInBusiness": { "title": "Minimum years in business", "minimum": 0, "type": "integer", "description": "Drop pros founded more recently than this. Computed from Porch's founding year, which is present on 58.1% of profiles; the other 41.9% are dropped whenever a floor is set. 0 = keep everyone.", "default": 0 }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "How many pro records to return, and your cost cap: 50 rows = $0.18, 1,000 = $3.50, 10,000 = $35. One record is one profile page fetched, at roughly 5 pros/second (measured: 399 pages in 87 seconds at the default concurrency). The prefilled 50 is a smoke test — raise it once you like the shape of the rows. Start a run without picking any trade, state, city or profile URL and the Actor runs the documented sample instead — 50 roofers in Texas, $0.18 — rather than charging you for a random nationwide slice.", "default": 1000 }, "skip": { "title": "Skip (paging across runs)", "minimum": 0, "type": "integer", "description": "Skip this many matching profiles before collecting. Results follow sitemap order, which is stable, so a maxItems=1000 run followed by skip=1000 continues where the first stopped instead of re-buying the same pros. It counts profiles SCANNED, not rows delivered: with no lead-quality filter on they are the same number, but if you use one, set skip to the \"pages fetched\" figure the previous run printed in its log or the next run will start inside ground you already paid for. All 785,653 sitemap URLs are unique — verified by walking all 32 child sitemaps end to end — so paging this way never returns a duplicate.", "default": 0 }, "includeServices": { "title": "Include the services list", "type": "boolean", "description": "Include the pro's full declared service list — the profile page itself truncates it at 5 behind \"+ Show all services\", this returns all of them. One pro in the 399-profile sample listed 476. Turn it off for a slimmer spreadsheet; serviceCount is returned either way and the price does not change.", "default": true }, "includeServiceArea": { "title": "Include the service area", "type": "boolean", "description": "Include the pro's coverage cities and ZIP codes. The median pro who publishes one covers 46 ZIPs; the widest in the 399-profile sample reached 872. Turn it off for a slimmer spreadsheet; serviceAreaCityCount and serviceAreaZipCount are returned either way and the price does not change.", "default": true }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel profile fetches. 8 is the tested default: live runs pulled 399 of 399 and 556 of 556 profile pages with zero failures at that setting. Higher values gain little because Porch rate-limits per exit IP — direct at concurrency 12 collapsed to 34.0% (132 HTTP 429s out of 200 requests).", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave it on Apify Proxy (automatic) — that is the measured-best rung and it needs no residential bandwidth. Porch never challenges you (no Cloudflare, no CAPTCHA, no cookie, no login); it only throttles per exit IP, so the Actor mints a fresh proxy session for every request and each one starts on a full token bucket. Switching the proxy off works for short jobs but collapses to HTTP 429 above roughly 10 requests/second from a single address.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }