{ "openapi": "3.0.1", "info": { "title": "Expertise.com Local Pro Directory Scraper", "description": "Scrape Expertise.com's curated \"best of\" directories of local professionals - lawyers, contractors, financial advisors, insurance agents and more - across 200+ service categories and every US city. Get business name, rating, review count, phone, website, address, and profile URL.", "version": "1.0", "x-build-id": "NeUMmetYU5ZjaSNgn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~expertise-com-local-pro-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-expertise-com-local-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/crawlerbros~expertise-com-local-pro-directory-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-expertise-com-local-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/crawlerbros~expertise-com-local-pro-directory-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-expertise-com-local-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": [ "mode", "state", "city" ], "properties": { "mode": { "title": "Mode", "enum": [ "byCategoryCity", "byCity" ], "type": "string", "description": "What to fetch.", "default": "byCategoryCity" }, "category": { "title": "Category", "enum": [ "", "business", "finance", "home-improvement", "insurance", "legal", "lifestyle" ], "type": "string", "description": "Top-level service vertical. mode=byCategoryCity: auto-derived/corrected from `subcategory` if they don't match, so this mainly matters when `subcategory` is a custom value outside the dropdown. mode=byCity: optional filter to restrict results to one vertical — leave on \"(none)\" to browse ALL verticals for the city.", "default": "" }, "subcategory": { "title": "Subcategory slug", "enum": [ "advertising-agencies", "branding-agencies", "business-consultants", "computer-repair", "content-marketing-agencies", "courier-services", "database-services", "digital-marketing-agencies", "employment-staffing-agencies", "graphic-designers", "healthcare-app-development-company", "internet-providers", "law-firm-marketing", "managed-service-providers", "marketing-consultants", "mobile-app-development", "non-profit-and-government-marketing-agency", "office-cleaning", "ppc-agencies", "print-shops", "private-investigators", "property-management", "public-relations-firms", "screen-printing-tshirts", "seo-agencies", "social-media-marketing", "software-development", "structural-engineers", "trade-schools", "user-experience", "voice-actors", "web-design", "web-developers", "accountant-cpa", "bookkeepers", "collection-agency", "credit-repair", "financial-advisors", "mortgage-refinance", "private-wealth-advisor", "tax-services-cpa", "ac-repair", "architects", "asbestos-removal-abatement", "blinds-drapes-window-treatments", "carpet-cleaners", "chimney-sweeps", "concrete-contractors", "countertops-granite-quartz", "deck-contractors", "demolition-contractors", "drywall-contractors", "electricians", "emergency-plumber", "fence-companies", "fire-damage-restoration", "flooring", "garage-doors", "glass-mirrors", "gutter-cleaner", "handyman", "hardwood-floor-refinishing", "heat-pumps", "home-appliance-repair", "home-inspection", "home-organizers", "home-security-systems", "home-staging", "home-theater-install", "house-cleaning", "hvac", "insulation", "interior-design", "junk-removal", "landscape-lighting", "landscaping", "lawn-service", "locksmiths", "long-distance-movers", "mold-remediation", "mortgage-brokers-lenders", "moving", "painting", "pest-control", "plumbing", "pool-cleaning-maintenance", "real-estate-agents", "remodeling", "roofing", "siding-contractors", "snow-removal", "solar-company", "sprinklers", "storage-units", "swimming-pools", "tree-services", "upholstery", "water-damage", "window-replacement-and-installation", "window-washing", "car-insurance", "health-insurance", "homeowners-insurance", "life-insurance", "pet-insurance", "renters-insurance", "arbitration-mediation", "bail-bonds", "bankruptcy-lawyers", "bicycle-accident-lawyers", "birth-injury-lawyers", "boat-accident-lawyers", "brain-injury-lawyers", "business-lawyers", "car-accident-lawyers", "child-support-lawyers", "construction-accident-lawyers", "criminal-lawyers", "defamation-lawyers", "disability-lawyers", "divorce-lawyers", "dog-bite-lawyers", "dui-lawyers", "employment-lawyers", "estate-planning-lawyers", "family-lawyers", "immigration-lawyers", "litigation-lawyers", "long-term-disability-lawyers", "medical-malpractice-lawyers", "motorcycle-accident-lawyers", "nursing-home-abuse-lawyers", "personal-injury-lawyers", "probate-lawyers", "real-estate-lawyers", "slip-and-fall-lawyers", "tax-lawyers", "truck-accident-lawyers", "va-disability-lawyers", "workers-comp-lawyers", "wrongful-death-lawyers", "maternity-photographers", "newborn-photography", "portrait-photographers", "real-estate-photographers", "tattoos", "wedding-photography" ], "type": "string", "description": "Expertise.com subcategory (mode=byCategoryCity, required). The matching top-level `category` vertical is auto-derived from this value, so you can leave `category` on its default. All 147 subcategories currently listed on expertise.com across all 6 verticals, verified live.", "default": "personal-injury-lawyers" }, "state": { "title": "State", "enum": [ "alabama", "alaska", "arizona", "arkansas", "california", "colorado", "connecticut", "delaware", "district-of-columbia", "florida", "georgia", "hawaii", "idaho", "illinois", "indiana", "iowa", "kansas", "kentucky", "louisiana", "maine", "maryland", "massachusetts", "michigan", "minnesota", "mississippi", "missouri", "montana", "nebraska", "nevada", "new-hampshire", "new-jersey", "new-mexico", "new-york", "north-carolina", "north-dakota", "ohio", "oklahoma", "oregon", "pennsylvania", "rhode-island", "south-carolina", "south-dakota", "tennessee", "texas", "utah", "vermont", "virginia", "washington", "west-virginia", "wisconsin", "wyoming" ], "type": "string", "description": "US state (or Washington DC).", "default": "california" }, "city": { "title": "City slug", "type": "string", "description": "City slug as used in the Expertise.com URL, e.g. `los-angeles`, `new-york`, `chicago`. Lowercase, spaces become hyphens.", "default": "los-angeles" }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop businesses with an aggregate rating below this value (0-5)." }, "minReviewCount": { "title": "Min review count", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop businesses with fewer than this many aggregate reviews." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "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 } } } } } } } } } }