{ "openapi": "3.0.1", "info": { "title": "Hipages Lead Extractor", "description": "Discover the highest rated tradespeople in your area instantly with our HiPages scraper. Extract comprehensive business profiles, genuine reviews, and phone numbers. Search across 120+ service categories and filter by location to find the perfect professionals for any job.", "version": "0.0", "x-build-id": "3rkE0hixNXX6lHnMi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/websift~hipages-lead-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-websift-hipages-lead-extractor", "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/websift~hipages-lead-extractor/runs": { "post": { "operationId": "runs-sync-websift-hipages-lead-extractor", "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/websift~hipages-lead-extractor/run-sync": { "post": { "operationId": "run-sync-websift-hipages-lead-extractor", "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": [ "category", "postcode" ], "properties": { "category": { "title": "Category", "enum": [ "Air Conditioning", "Antenna Servicesappliance Installation", "Appliance Repairs", "Arborists", "Architects", "Asbestos Removal", "Awning Suppliers", "Balustrades", "Bamboo Flooring", "Bath Resurfacing", "Bathroom Accessories", "Bathroom Renovations", "Blinds", "Bricklayers", "Builders", "Building Certifiers", "Building Consultants", "Building Designers", "Building Inspections", "Building Suppliers", "Building Surveyors", "Cabinet Makers", "Carpenters", "Carpet Cleaning", "Carpet Layers", "Carpets", "Carports", "Ceiling Repair", "Chimney Sweepers", "Cladding", "Cleaning Services", "Commercial Cleaning", "Concrete Kerbs", "Concrete Resurfacing", "Concretors", "Construction Project Management", "Curtains", "Custom Furniture", "Damp Proofing", "Decking", "Demolition", "Door Suppliers", "Doors", "Drafters", "Electricians", "Equipment Hire", "Ev Charger Installation", "Excavation", "Fences", "Floor Coatings", "Floor Sanding", "Fly Screens", "Furniture Removal", "Garages", "Garden Designers", "Gardeners", "Gas Fitters", "Gates", "Gazebos", "Glass Glazier", "Gutter Cleaning", "Guttering", "Handrails", "Handyman", "Heaters", "Heating Systems", "Home Automation", "Home Renovations", "Home Security", "Home Theatre", "Homewares", "Hot Water Systems", "Insulation", "Interior Decorators", "Interior Designers", "Irrigation Systems", "Joiners", "Kitchen Designers", "Kitchen Renovations", "Landscape Architecture", "Landscaper Gardener", "Lawn Mowing", "Lawn Turf", "Lighting", "Locksmiths", "Painters", "Patios", "Paver", "Pergolas", "Pest Control", "Pest Inspections", "Plastering", "Plumbers", "Pool Fencing", "Pool Heating", "Pool Maintenance", "Pressure Cleaner", "Privacy Screens", "Professional Organisers", "Render", "Renderer", "Retaining Walls", "Roller Shutters", "Roof Repairs", "Roofing", "Rubbish Removal", "Scaffolding", "Security Screens Doors", "Shade Sails", "Sheds", "Shopfitters", "Shower Screens", "Skip Truck Hire", "Skylights", "Solar Panel Cleaners", "Solar Power", "Splashbacks", "Stained Glass", "Staircases", "Stonemasons", "Storage", "Structural Engineer", "Surveyor", "Swimming Pool Builders", "Tilers", "Timber Flooring", "Town Planning Consultants", "Tree Fellers", "Underfloor Heating Systems", "Underpinning", "Upholstery Repair", "Ventilation", "Verandahs", "Vinyl Laminate", "Wallpapering", "Wardrobe Makers", "Waterproofing", "Window Cleaning", "Window Repairs", "Window Shutters", "Window Tinting", "Windows" ], "type": "string", "description": "Category to search." }, "postcode": { "title": "PostCode", "type": "integer", "description": "Enter the postcode you want to search for companies in." }, "sortBy": { "title": "Sort By", "enum": [ "Rating", "Total Hired", "Total Recommendations" ], "type": "string", "description": "Choose how to sort the job listings.", "default": "Rating" } } }, "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 } } } } } } } } } }