{ "openapi": "3.0.1", "info": { "title": "Angi Scraper [Only $0.9] | Contractor Leads | Reviews | Ratings", "description": "Extract contractor profiles, reviews, ratings, phone, website, and license info from Angi.com for any US trade and city. Build lead lists, monitor reputation, and run market research on America's largest home-services directory.", "version": "0.1", "x-build-id": "971rltIlfxvHZFVZp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~angi-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-angi-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/ahmed_jasarevic~angi-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-angi-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/ahmed_jasarevic~angi-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-angi-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Angi search pages (/companylist/us///.htm), category hubs (/nearme/...) or direct contractor profile pages to scrape.", "default": [ { "url": "https://www.angi.com/companylist/us/tx/dallas/plumbing.htm" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "trade": { "title": "Trade / category", "type": "string", "description": "Service trade slug, e.g. plumbing, roofing, electricians. Combined with State + City to build a search URL (optional if Start URLs are given)." }, "state": { "title": "State code", "type": "string", "description": "Two-letter US state code, e.g. tx, ca, ny." }, "city": { "title": "City", "type": "string", "description": "City name, e.g. dallas, austin." }, "maxPages": { "title": "Max search pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many result pages to walk per search (?page=N). ~10 unique contractors per page.", "default": 5 }, "maxItems": { "title": "Max contractors", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum contractor profiles to output (paying users; free users are capped at a 10-item preview). When reviews are enabled, each review is a separate row.", "default": 100 }, "includeReviews": { "title": "Include individual reviews", "type": "boolean", "description": "Visit each contractor profile to extract individual reviews, phone, website and license info (slower, more requests). Turn off for fast listing-only runs.", "default": true }, "maxReviewsPerProfile": { "title": "Max reviews per profile", "minimum": 0, "maximum": 500, "type": "integer", "description": "Cap on individual reviews extracted per contractor.", "default": 50 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route traffic through Apify Proxy. angi.com walls datacenter/VPS IPs with Cloudflare — keep this ON (residential group recommended).", "default": true }, "proxyGroups": { "title": "Proxy groups", "type": "array", "description": "Apify proxy groups to use (RESIDENTIAL recommended for angi.com — datacenter IPs are Cloudflare-blocked).", "items": { "type": "string" }, "default": [ "RESIDENTIAL" ] }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests. Higher values are faster but may trigger anti-bot limits.", "default": 10 }, "maxRequestsPerCrawl": { "title": "Max requests per crawl", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on total HTTP requests per run (loop safety).", "default": 1000 } } }, "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 } } } } } } } } } }