{ "openapi": "3.0.1", "info": { "title": "Angi (Angie's List) Pro Directory Scraper", "description": "Scrape the Angi pro directory for service-pros by ZIP and category. Returns business name, service categories, service-area ZIPs, rating, review count, certified flag, Super Service Award, address, phone, and website. For home-services SaaS, contractor CRMs, and competitive intel.", "version": "0.1", "x-build-id": "OJo49UD62URFrDXSy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~angies-list-angi-pro-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-angies-list-angi-pro-directory-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/jungle_synthesizer~angies-list-angi-pro-directory-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-angies-list-angi-pro-directory-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/jungle_synthesizer~angies-list-angi-pro-directory-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-angies-list-angi-pro-directory-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", "required": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "mode": { "title": "Mode", "enum": [ "catalog", "pro_detail" ], "type": "string", "description": "Catalog crawl via pro_profile sitemap, or scrape specific pro URLs.", "default": "catalog" }, "zipCodes": { "title": "ZIP Codes", "type": "array", "description": "Filter catalog to the US state(s) these ZIP codes resolve to (state-level, not exact ZIP). Leave empty for no geography filter.", "items": { "type": "string" } }, "categories": { "title": "Service Categories", "type": "array", "description": "Angi's real home-service categories. Leave empty for all.", "items": { "type": "string", "enum": [ "affordable-plumbers", "air-duct-cleaning", "animal-removal", "appliance-repair", "appliance-sales", "appraisals", "aquarium-services", "arborists", "architects", "asbestos-removal", "awnings", "backsplash-installation", "barndominium-builders", "basement-leak-repair", "basement-waterproofing", "basketball-goals", "bathroom-fan-installation", "bathtub-refinishing", "bathtub-replacement", "biohazard-remediation", "bird-control", "blind-cleaning", "boiler-repair", "brush-chipping", "buffing-and-polishing", "cabinet-contractors", "cabinet-makers", "cabinet-refinishing", "carpentry", "carpet", "carpet-cleaning", "carpet-stretching", "caulking-services", "ceiling-fans", "central-vacuum-cleaners", "central-vacuum-systems", "ceramic-tile", "chandelier-installation", "childproofing", "chimney-caps", "chimney-inspection", "chimney-liner-installation", "chimney-repair", "chimney-sweep", "cleaning", "closets", "computer-repair", "concrete-cutting", "concrete-disposal", "concrete-driveways", "concrete-finishing", "concrete-leveling", "concrete-mudjacking", "concrete-patio-companies", "concrete-repair", "concrete-resurfacing", "concrete-stamped-decorative", "concrete-walls", "contractor", "couch-cleaning-services", "countertops", "custom-home-builders", "deck-cleaning", "deck-maintenance", "deck-repair", "deck-staining", "decks-and-porches", "dirt-hauling", "dishwasher-installation", "dock-building-repair", "door-repair", "doorbell-installation", "doors", "drain-cleaning", "drain-pipe-installation", "drapery-cleaning", "driveway-gates", "driveway-sealcoating", "driveways", "dryer-vent-cleaning", "drywall", "drywall-insulation", "dumpster-rental", "earthquake-retrofit", "egress", "eifs-installers", "electrical", "energy-audit", "epoxy-flooring", "ev-charger-installer", "excavating", "exhaust-fan-installation", "exterior-painting", "fence-painting", "fencing", "fire-pit-installation", "fire-sprinkler-companies", "fireplace-cleaners", "fireplaces", "floor-cleaning", "floor-polishers", "floor-repair-companies", "floor-sanding", "flooring", "foundation-drain-installation", "foundation-repair", "fountains", "french-drains", "furniture-refinishing", "furniture-reupholstery", "garage-builders", "garage-cleaning-services", "garage-doors", "garage-floor-coatings", "garbage-collection", "garbage-disposal-repair", "garbage-removal", "gas-fireplace-repair", "gas-fireplace-service", "gas-grill-installation", "gas-grill-repair", "gas-leak-repair", "gas-logs", "gate-repair", "gazebos", "ge-appliance-repair", "generator-installers", "glass-and-mirrors", "glass-block", "glass-block-windows", "glaziers", "grab-bar-installation", "granite-countertop-companies", "granite-restoration", "gravel-driveway-repair", "greenhouses", "grill-assembly", "grout-tile-cleaners", "gutter-cleaning", "gutter-repair-replacement", "handyman-service", "hardwood-flooring", "hauling", "heating-oil-companies", "holiday-decorating", "home-and-garage-organization", "home-automation", "home-builders", "home-inspection", "home-phone-service", "home-security-systems", "home-staging", "home-theater-systems", "home-warranty-companies", "house-cleaning", "house-leveling", "humidifier-repair", "hurricane-film", "hurricane-shutters", "hvac", "install-above-ground-pools", "install-boiler", "install-central-vacuum", "install-garbage-disposal", "install-putting-green", "install-stair-railings", "insulation", "interior-design", "interior-painting", "kenmore-vacuum-repair", "kitchen-and-bath-remodeling", "kitchen-cabinet-refacing", "land-clearing-services", "land-surveying", "landscaping", "landscaping-hardscaping-and-pavers", "landscaping-lighting", "lawn-and-yard-work", "lawn-care", "lawn-fertilization-and-treatment", "lawn-irrigation", "lawn-mower-repair", "lead-testing-and-removal", "leaf-removal", "leather-and-vinyl-repair", "lighting", "locksmiths", "mailbox-repair", "marble-and-granite", "marble-restoration", "masonry", "mattress-cleaning", "metal-fabrication-and-restoration", "mold-testing-and-remediation", "moving", "mulch-and-topsoil", "nest-installation", "oriental-rug-cleaning", "outdoor-kitchens", "outdoor-light-repair", "painting", "patio-covers", "patios", "paving-services", "percolation-tests", "pest-control", "pet-fencing", "phone-repair", "piano-moving", "plant-nurseries", "plant-watering", "plaster-plaster-repair", "playground-equipment", "plumbing", "plumbing-handymen", "plumbing-heating-companies", "pole-barn-builders", "pool-and-spa-service", "pool-table-assembly", "popcorn-ceilings", "porcelain-refinish-repair", "pre-made-cabinets", "pressure-washing", "property-appraiser", "radon-testing", "range-hoods", "real-estate-agents", "remodel-design", "remodeling-basements", "remodeling-modular-and-mobile-home", "repair-bathroom-tile", "repair-carport", "repair-chain-link-fence", "repair-countertops", "repair-granite-countertops", "repair-patio", "repair-sewer-line", "repair-vinyl-siding", "residential-design", "retaining-wall-installers", "ring-installers", "roof-cleaning", "roof-ice-and-snow-removal", "roofing", "roto-tilling", "sand-rock-delivery", "sandblasting-services", "satellite-tv-service", "sauna-installation", "screen-repair", "security-doors", "septic-tank", "sewer-cleaning", "shower-glass-companies", "siding", "sink-installation", "sink-reglazing", "sink-repair", "skylights", "small-appliance-repair", "smoke-detector-installers", "snow-removal", "solar-panels", "sonic-cleaning", "stair-companies", "stone-and-gravel", "stone-countertops", "storm-drain-installation", "storm-shelters", "structural-engineering", "stucco", "subcontractors", "sump-pump-installation", "sunroom-and-patio-remodeling", "swimming-pools", "tennis-court-contractors", "toilets", "trampoline-assembly", "tree-service", "treehouse-builders", "tub-shower-conversion", "tv-antenna", "tv-antenna-installation", "tv-mount-install", "upholstering", "upholstery-cleaning", "vinyl-siding-cleaning", "wall-repair", "wallpaper-removal", "wallpapering", "waste-removal-services", "water-and-smoke-damage", "water-heaters", "water-softeners", "weed-services", "welding", "wells-and-pumps", "window-cleaning", "window-door-contractors", "window-screen-repair", "window-shutter-repair", "window-shutters", "window-tinting", "window-treatments", "windows", "wood-stove-companies", "wood-stove-inspection", "wood-stove-repair", "wood-stripping-companies", "woodworking", "wrought-iron", "wrought-iron-fencing-repair" ], "enumTitles": [ "Affordable Plumbers", "Air Duct Cleaning", "Animal Removal", "Appliance Repair", "Appliance Sales", "Appraisals", "Aquarium Services", "Arborists", "Architects", "Asbestos Removal", "Awnings", "Backsplash Installation", "Barndominium Builders", "Basement Leak Repair", "Basement Waterproofing", "Basketball Goals", "Bathroom Fan Installation", "Bathtub Refinishing", "Bathtub Replacement", "Biohazard Remediation", "Bird Control", "Blind Cleaning", "Boiler Repair", "Brush Chipping", "Buffing And Polishing", "Cabinet Contractors", "Cabinet Makers", "Cabinet Refinishing", "Carpentry", "Carpet", "Carpet Cleaning", "Carpet Stretching", "Caulking Services", "Ceiling Fans", "Central Vacuum Cleaners", "Central Vacuum Systems", "Ceramic Tile", "Chandelier Installation", "Childproofing", "Chimney Caps", "Chimney Inspection", "Chimney Liner Installation", "Chimney Repair", "Chimney Sweep", "Cleaning", "Closets", "Computer Repair", "Concrete Cutting", "Concrete Disposal", "Concrete Driveways", "Concrete Finishing", "Concrete Leveling", "Concrete Mudjacking", "Concrete Patio Companies", "Concrete Repair", "Concrete Resurfacing", "Concrete Stamped Decorative", "Concrete Walls", "Contractor", "Couch Cleaning Services", "Countertops", "Custom Home Builders", "Deck Cleaning", "Deck Maintenance", "Deck Repair", "Deck Staining", "Decks And Porches", "Dirt Hauling", "Dishwasher Installation", "Dock Building Repair", "Door Repair", "Doorbell Installation", "Doors", "Drain Cleaning", "Drain Pipe Installation", "Drapery Cleaning", "Driveway Gates", "Driveway Sealcoating", "Driveways", "Dryer Vent Cleaning", "Drywall", "Drywall Insulation", "Dumpster Rental", "Earthquake Retrofit", "Egress", "EIFS Installers", "Electrical", "Energy Audit", "Epoxy Flooring", "EV Charger Installer", "Excavating", "Exhaust Fan Installation", "Exterior Painting", "Fence Painting", "Fencing", "Fire Pit Installation", "Fire Sprinkler Companies", "Fireplace Cleaners", "Fireplaces", "Floor Cleaning", "Floor Polishers", "Floor Repair Companies", "Floor Sanding", "Flooring", "Foundation Drain Installation", "Foundation Repair", "Fountains", "French Drains", "Furniture Refinishing", "Furniture Reupholstery", "Garage Builders", "Garage Cleaning Services", "Garage Doors", "Garage Floor Coatings", "Garbage Collection", "Garbage Disposal Repair", "Garbage Removal", "Gas Fireplace Repair", "Gas Fireplace Service", "Gas Grill Installation", "Gas Grill Repair", "Gas Leak Repair", "Gas Logs", "Gate Repair", "Gazebos", "GE Appliance Repair", "Generator Installers", "Glass And Mirrors", "Glass Block", "Glass Block Windows", "Glaziers", "Grab Bar Installation", "Granite Countertop Companies", "Granite Restoration", "Gravel Driveway Repair", "Greenhouses", "Grill Assembly", "Grout Tile Cleaners", "Gutter Cleaning", "Gutter Repair Replacement", "Handyman Service", "Hardwood Flooring", "Hauling", "Heating Oil Companies", "Holiday Decorating", "Home And Garage Organization", "Home Automation", "Home Builders", "Home Inspection", "Home Phone Service", "Home Security Systems", "Home Staging", "Home Theater Systems", "Home Warranty Companies", "House Cleaning", "House Leveling", "Humidifier Repair", "Hurricane Film", "Hurricane Shutters", "HVAC", "Install Above Ground Pools", "Install Boiler", "Install Central Vacuum", "Install Garbage Disposal", "Install Putting Green", "Install Stair Railings", "Insulation", "Interior Design", "Interior Painting", "Kenmore Vacuum Repair", "Kitchen And Bath Remodeling", "Kitchen Cabinet Refacing", "Land Clearing Services", "Land Surveying", "Landscaping", "Landscaping Hardscaping And Pavers", "Landscaping Lighting", "Lawn And Yard Work", "Lawn Care", "Lawn Fertilization And Treatment", "Lawn Irrigation", "Lawn Mower Repair", "Lead Testing And Removal", "Leaf Removal", "Leather And Vinyl Repair", "Lighting", "Locksmiths", "Mailbox Repair", "Marble And Granite", "Marble Restoration", "Masonry", "Mattress Cleaning", "Metal Fabrication And Restoration", "Mold Testing And Remediation", "Moving", "Mulch And Topsoil", "Nest Installation", "Oriental Rug Cleaning", "Outdoor Kitchens", "Outdoor Light Repair", "Painting", "Patio Covers", "Patios", "Paving Services", "Percolation Tests", "Pest Control", "Pet Fencing", "Phone Repair", "Piano Moving", "Plant Nurseries", "Plant Watering", "Plaster Plaster Repair", "Playground Equipment", "Plumbing", "Plumbing Handymen", "Plumbing Heating Companies", "Pole Barn Builders", "Pool And Spa Service", "Pool Table Assembly", "Popcorn Ceilings", "Porcelain Refinish Repair", "Pre Made Cabinets", "Pressure Washing", "Property Appraiser", "Radon Testing", "Range Hoods", "Real Estate Agents", "Remodel Design", "Remodeling Basements", "Remodeling Modular And Mobile Home", "Repair Bathroom Tile", "Repair Carport", "Repair Chain Link Fence", "Repair Countertops", "Repair Granite Countertops", "Repair Patio", "Repair Sewer Line", "Repair Vinyl Siding", "Residential Design", "Retaining Wall Installers", "Ring Installers", "Roof Cleaning", "Roof Ice And Snow Removal", "Roofing", "Roto Tilling", "Sand Rock Delivery", "Sandblasting Services", "Satellite TV Service", "Sauna Installation", "Screen Repair", "Security Doors", "Septic Tank", "Sewer Cleaning", "Shower Glass Companies", "Siding", "Sink Installation", "Sink Reglazing", "Sink Repair", "Skylights", "Small Appliance Repair", "Smoke Detector Installers", "Snow Removal", "Solar Panels", "Sonic Cleaning", "Stair Companies", "Stone And Gravel", "Stone Countertops", "Storm Drain Installation", "Storm Shelters", "Structural Engineering", "Stucco", "Subcontractors", "Sump Pump Installation", "Sunroom And Patio Remodeling", "Swimming Pools", "Tennis Court Contractors", "Toilets", "Trampoline Assembly", "Tree Service", "Treehouse Builders", "Tub Shower Conversion", "TV Antenna", "TV Antenna Installation", "TV Mount Install", "Upholstering", "Upholstery Cleaning", "Vinyl Siding Cleaning", "Wall Repair", "Wallpaper Removal", "Wallpapering", "Waste Removal Services", "Water And Smoke Damage", "Water Heaters", "Water Softeners", "Weed Services", "Welding", "Wells And Pumps", "Window Cleaning", "Window Door Contractors", "Window Screen Repair", "Window Shutter Repair", "Window Shutters", "Window Tinting", "Window Treatments", "Windows", "Wood Stove Companies", "Wood Stove Inspection", "Wood Stove Repair", "Wood Stripping Companies", "Woodworking", "Wrought Iron", "Wrought Iron Fencing Repair" ] }, "default": [] }, "proUrls": { "title": "Pro URL(s)", "type": "array", "description": "Specific Angi pro profile URLs to scrape (used in pro_detail mode).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "certifiedOnly": { "title": "Certified / Verified Pros Only", "type": "boolean", "description": "Only return pros with Angi-certified status.", "default": false }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of pro records to return. 0 = unlimited.", "default": 10 } } }, "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 } } } } } } } } } }