ScraperCity logo

Angi (Angie's List) Scraper API Documentation

Angi (Angie's List) Scraper

Extract verified home service professionals from Angi with ratings and contact details

$0.01 per listingPOST /api/v1/scrape/angi-angies-list-scraper

Parameters

NameTypeRequiredDescription
keywordstringRequiredService category slug. Valid values: air-duct-cleaning, animal-removal, tv-antenna, appliance-repair, architects, asbestos-removal, awnings, remodeling-basements, basement-waterproofing, basketball-goals, bathtub-refinishing, biohazard-remediation, blind-cleaning, cabinet-makers, cabinet-refinishing, carpet-cleaning, carpet, ceiling-fans, central-vacuum-cleaners, childproofing, chimney-caps, chimney-repair, chimney-sweep, cleaning, closets, computer-repair, concrete-driveways, concrete-repair, countertops, deck-maintenance, decks-and-porches, dock-building-repair, pet-fencing, doors, drain-cleaning, drain-pipe-installation, drapery-cleaning, driveway-gates, driveways, dryer-vent-cleaning, drywall, dumpster-rental, earthquake-retrofit, egress, electrical, epoxy-flooring, excavating, fencing, fireplaces, firewood, buffing-and-polishing, floor-cleaning, flooring, foundation-repair, fountains, furniture-refinishing, garage-builders, garage-doors, gas-logs, gas-leak-repair, contractor, generator-installers, glass-block, glass-and-mirrors, gas-grill-repair, gutter-cleaning, gutter-repair-replacement, handyman-service, landscaping-hardscaping-and-pavers, hardwood-flooring, hauling, heating-oil-companies, holiday-decorating, home-automation, home-builders, energy-audit, home-inspection, kitchen-and-bath-remodeling, home-security-systems, home-staging, home-theater-systems, home-warranty-companies, house-cleaning, exterior-painting, hurricane-shutters, hvac, insulation, interior-design, interior-painting, wrought-iron, lawn-irrigation, appraisals, land-surveying, landscaping-lighting, appliance-sales, landscaping, lawn-and-yard-work, lawn-mower-repair, lawn-fertilization-and-treatment, lead-testing-and-removal, leaf-removal, leather-and-vinyl-repair, lighting, locksmiths, mailbox-repair, marble-and-granite, masonry, metal-fabrication-and-restoration, remodeling-modular-and-mobile-home, mold-testing-and-remediation, moving, concrete-leveling, mulch-and-topsoil, plant-nurseries, oriental-rug-cleaning, outdoor-kitchens, sunroom-and-patio-remodeling, patios, pest-control, home-phone-service, phone-repair, piano-moving, plaster-plaster-repair, playground-equipment, plumbing, pool-and-spa-service, swimming-pools, pressure-washing, home-and-garage-organization, radon-testing, real-estate-agents, property-appraiser, roof-cleaning, roof-ice-and-snow-removal, roofing, roto-tilling, satellite-tv-service, screen-repair, septic-tank, sewer-cleaning, siding, skylights, small-appliance-repair, snow-removal, solar-panels, concrete-stamped-decorative, stone-and-gravel, structural-engineering, stucco, ceramic-tile, garbage-collection, tree-service, upholstering, upholstery-cleaning, wallpapering, wallpaper-removal, water-and-smoke-damage, water-heaters, water-softeners, welding, wells-and-pumps, window-cleaning, windows, hurricane-film, window-tinting, window-treatments, woodworkingExample: plumbing
zipCodesstring[]OptionalZip codes to search within (optional)Example: ["90210", "10001"]
maxItemsnumberOptionalMaximum results to extract (0 for unlimited)Default: 100Example: 500

Examples

Find plumbers in specific zip codes

curl -X POST https://app.scrapercity.com/api/v1/scrape/angi-angies-list-scraper \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "plumbing",
    "zipCodes": ["75201", "75202", "75203"],
    "maxItems": 200
  }'

Search electricians nationwide

curl -X POST https://app.scrapercity.com/api/v1/scrape/angi-angies-list-scraper \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "electrical",
    "maxItems": 1000
  }'

Extract HVAC contractors

curl -X POST https://app.scrapercity.com/api/v1/scrape/angi-angies-list-scraper \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "hvac",
    "zipCodes": ["60601", "60602"],
    "maxItems": 100
  }'

Use Cases

  • Lead generation for B2B home services companies
  • Market research on service provider density
  • Competitive analysis of local service businesses
  • Building partnerships with verified contractors
  • Analyzing customer satisfaction trends by region
  • Price comparison across service categories

Best Practices

  • Use exact category slugs from the list above (167 available)
  • Leave zip codes empty to search nationwide
  • Returns verified businesses with customer grades (A-F)
  • Includes complete contact info and business hours
  • Shows licensing, insurance, and certification status
  • Set maxItems to 0 for unlimited results
  • Results include years in business and service areas
  • Can be cancelled while running

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.