{ "openapi": "3.0.1", "info": { "title": "Local Business & Professional Leads Scraper for Expertise.com", "description": "Scrape Expertise.com 'best in city' lists of financial advisors, accountants, lawyers, insurance agencies, agencies and home-service pros: rank, phone, website, address, rating, review sites, licence and a lead score. Optional e-mail lookup. Independent tool, not affiliated with Expertise.com.", "version": "0.1", "x-build-id": "MKuXqbO4A7XWvh5dS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~expertise-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-expertise-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/scrapesage~expertise-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-expertise-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/scrapesage~expertise-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-expertise-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" ], "properties": { "mode": { "title": "What to scrape", "enum": [ "search", "startUrls" ], "type": "string", "description": "Search reads the \"best in city\" lists for the categories and locations below (plus any Start URLs you add). Start URLs reads only the Expertise.com pages you paste.", "default": "search" }, "categories": { "title": "Categories", "type": "array", "description": "Pick one or more professions. The first five entries select every category of a group at once (for example all 35 legal practice areas). A category only returns businesses in cities where Expertise.com publishes that list. Leave Categories and Locations both empty to run a quick sample (Financial Advisors in Houston, TX).", "items": { "type": "string", "enum": [ "finance", "legal", "insurance", "home-improvement", "business", "accountant-cpa", "bookkeepers", "financial-advisors", "mortgage-refinance", "credit-repair", "private-wealth-advisor", "collection-agency", "tax-services-cpa", "employment-lawyers", "business-lawyers", "tax-lawyers", "dui-lawyers", "bankruptcy-lawyers", "divorce-lawyers", "criminal-lawyers", "personal-injury-lawyers", "real-estate-lawyers", "immigration-lawyers", "litigation-lawyers", "arbitration-mediation", "bail-bonds", "probate-lawyers", "car-accident-lawyers", "estate-planning-lawyers", "medical-malpractice-lawyers", "child-support-lawyers", "motorcycle-accident-lawyers", "boat-accident-lawyers", "family-lawyers", "workers-comp-lawyers", "truck-accident-lawyers", "wrongful-death-lawyers", "disability-lawyers", "va-disability-lawyers", "construction-accident-lawyers", "bicycle-accident-lawyers", "nursing-home-abuse-lawyers", "brain-injury-lawyers", "dog-bite-lawyers", "long-term-disability-lawyers", "slip-and-fall-lawyers", "birth-injury-lawyers", "defamation-lawyers", "car-insurance", "homeowners-insurance", "life-insurance", "renters-insurance", "health-insurance", "pet-insurance", "home-inspection", "moving", "carpet-cleaners", "junk-removal", "landscaping", "snow-removal", "pest-control", "electricians", "plumbing", "lawn-service", "house-cleaning", "landscape-lighting", "painting", "fence-companies", "flooring", "hvac", "handyman", "home-appliance-repair", "garage-doors", "deck-contractors", "architects", "concrete-contractors", "interior-design", "demolition-contractors", "drywall-contractors", "siding-contractors", "locksmiths", "home-theater-install", "hardwood-floor-refinishing", "home-staging", "chimney-sweeps", "gutter-cleaner", "roofing", "glass-mirrors", "heat-pumps", "mortgage-brokers-lenders", "countertops-granite-quartz", "home-organizers", "pool-cleaning-maintenance", "home-security-systems", "asbestos-removal-abatement", "insulation", "emergency-plumber", "real-estate-agents", "fire-damage-restoration", "ac-repair", "mold-remediation", "remodeling", "tree-services", "water-damage", "upholstery", "sprinklers", "window-washing", "swimming-pools", "window-replacement-and-installation", "blinds-drapes-window-treatments", "storage-units", "solar-company", "long-distance-movers", "computer-repair", "print-shops", "property-management", "private-investigators", "advertising-agencies", "office-cleaning", "digital-marketing-agencies", "screen-printing-tshirts", "public-relations-firms", "courier-services", "employment-staffing-agencies", "business-consultants", "marketing-consultants", "ppc-agencies", "branding-agencies", "seo-agencies", "mobile-app-development", "content-marketing-agencies", "internet-providers", "graphic-designers", "social-media-marketing", "managed-service-providers", "web-design", "voice-actors", "structural-engineers", "user-experience", "web-developers", "software-development", "trade-schools", "law-firm-marketing", "non-profit-and-government-marketing-agency", "database-services" ], "enumTitles": [ "Finance: ALL 8 categories (finance)", "Legal: ALL 35 categories (legal)", "Insurance: ALL 6 categories (insurance)", "Home Improvement: ALL 59 categories (home-improvement)", "Business: ALL 32 categories (business)", "Finance: Accountants (accountant-cpa)", "Finance: Bookkeeping Services (bookkeepers)", "Finance: Financial Advisors (financial-advisors)", "Finance: Mortgage Refinance Companies (mortgage-refinance)", "Finance: Credit Repair Companies (credit-repair)", "Finance: Private Wealth Advisors (private-wealth-advisor)", "Finance: Collection Agencies (collection-agency)", "Finance: Tax Services (tax-services-cpa)", "Legal: Employment Lawyers (employment-lawyers)", "Legal: Business Lawyers (business-lawyers)", "Legal: Tax Lawyers (tax-lawyers)", "Legal: DUI Lawyers (dui-lawyers)", "Legal: Bankruptcy Lawyers (bankruptcy-lawyers)", "Legal: Divorce Lawyers (divorce-lawyers)", "Legal: Criminal Defense Lawyers (criminal-lawyers)", "Legal: Personal Injury Lawyers (personal-injury-lawyers)", "Legal: Real Estate Lawyers (real-estate-lawyers)", "Legal: Immigration Lawyers (immigration-lawyers)", "Legal: Litigation Lawyers (litigation-lawyers)", "Legal: Mediators & Arbitrators (arbitration-mediation)", "Legal: Bail Bond Companies (bail-bonds)", "Legal: Probate Lawyers (probate-lawyers)", "Legal: Car Accident Lawyers (car-accident-lawyers)", "Legal: Estate Planning Lawyers (estate-planning-lawyers)", "Legal: Medical Malpractice Lawyers (medical-malpractice-lawyers)", "Legal: Child Support Lawyers (child-support-lawyers)", "Legal: Motorcycle Accident Lawyers (motorcycle-accident-lawyers)", "Legal: Boat Accident Lawyers (boat-accident-lawyers)", "Legal: Family Lawyers (family-lawyers)", "Legal: Workers Compensation Lawyers (workers-comp-lawyers)", "Legal: Truck Accident Lawyers (truck-accident-lawyers)", "Legal: Wrongful Death Lawyers (wrongful-death-lawyers)", "Legal: Social Security & Disability Lawyers (disability-lawyers)", "Legal: VA Disability Lawyers (va-disability-lawyers)", "Legal: Construction Accident Lawyers (construction-accident-lawyers)", "Legal: Bicycle Accident Lawyers (bicycle-accident-lawyers)", "Legal: Nursing Home Abuse Lawyers (nursing-home-abuse-lawyers)", "Legal: Brain Injury Lawyers (brain-injury-lawyers)", "Legal: Dog Bite Lawyers (dog-bite-lawyers)", "Legal: Long Term Disability Lawyers (long-term-disability-lawyers)", "Legal: Slip And Fall Lawyers (slip-and-fall-lawyers)", "Legal: Birth Injury Lawyers (birth-injury-lawyers)", "Legal: Defamation Lawyers (defamation-lawyers)", "Insurance: Local Car Insurance Agencies (car-insurance)", "Insurance: Homeowners Insurance Agencies (homeowners-insurance)", "Insurance: Life Insurance Companies (life-insurance)", "Insurance: Renters Insurance Companies (renters-insurance)", "Insurance: Health Insurance Agencies (health-insurance)", "Insurance: Pet Insurance Companies (pet-insurance)", "Home Improvement: Home Inspection Companies (home-inspection)", "Home Improvement: Moving Companies (moving)", "Home Improvement: Carpet Cleaners (carpet-cleaners)", "Home Improvement: Junk Removal Services (junk-removal)", "Home Improvement: Landscaping Services (landscaping)", "Home Improvement: Snow Removal Services (snow-removal)", "Home Improvement: Pest Control Services (pest-control)", "Home Improvement: Electricians (electricians)", "Home Improvement: Plumbers (plumbing)", "Home Improvement: Lawn Care Services (lawn-service)", "Home Improvement: House Cleaning Services (house-cleaning)", "Home Improvement: Landscape Lighting Companies (landscape-lighting)", "Home Improvement: Painters (painting)", "Home Improvement: Fence Companies (fence-companies)", "Home Improvement: Flooring Companies (flooring)", "Home Improvement: HVAC & Furnace Repair Services (hvac)", "Home Improvement: Handymen (handyman)", "Home Improvement: Home Appliance Repair Services (home-appliance-repair)", "Home Improvement: Garage Door Repair Companies (garage-doors)", "Home Improvement: Deck Contractors (deck-contractors)", "Home Improvement: Architects (architects)", "Home Improvement: Concrete Contractors (concrete-contractors)", "Home Improvement: Interior Design Services (interior-design)", "Home Improvement: Demolition Contractors (demolition-contractors)", "Home Improvement: Drywall Contractors (drywall-contractors)", "Home Improvement: Siding Contractors (siding-contractors)", "Home Improvement: Locksmiths (locksmiths)", "Home Improvement: Home Theater Installation Services (home-theater-install)", "Home Improvement: Hardwood Flooring Companies (hardwood-floor-refinishing)", "Home Improvement: Home Staging Companies (home-staging)", "Home Improvement: Chimney Sweepers (chimney-sweeps)", "Home Improvement: Gutter Cleaning Services (gutter-cleaner)", "Home Improvement: Roofers (roofing)", "Home Improvement: Glass Companies (glass-mirrors)", "Home Improvement: Heat Pump Contractors (heat-pumps)", "Home Improvement: Mortgage Brokers (mortgage-brokers-lenders)", "Home Improvement: Countertop Companies (countertops-granite-quartz)", "Home Improvement: Home Organizers (home-organizers)", "Home Improvement: Pool Cleaners (pool-cleaning-maintenance)", "Home Improvement: Home Security Companies (home-security-systems)", "Home Improvement: Asbestos Removal Companies (asbestos-removal-abatement)", "Home Improvement: Insulation Contractors (insulation)", "Home Improvement: Emergency Plumbers (emergency-plumber)", "Home Improvement: Real Estate Agents (real-estate-agents)", "Home Improvement: Fire Damage Restoration Services (fire-damage-restoration)", "Home Improvement: AC Repair Services (ac-repair)", "Home Improvement: Mold Remediation Companies (mold-remediation)", "Home Improvement: Remodeling Contractors (remodeling)", "Home Improvement: Tree Services (tree-services)", "Home Improvement: Water Damage Restoration Services (water-damage)", "Home Improvement: Upholstery Services (upholstery)", "Home Improvement: Irrigation & Sprinkler Companies (sprinklers)", "Home Improvement: Window Washing Services (window-washing)", "Home Improvement: Swimming Pool Contractors (swimming-pools)", "Home Improvement: Window Contractors (window-replacement-and-installation)", "Home Improvement: Window Treatment Companies (blinds-drapes-window-treatments)", "Home Improvement: Storage Units (storage-units)", "Home Improvement: Solar Companies (solar-company)", "Home Improvement: Long Distance Movers (long-distance-movers)", "Business: Computer Repair Shops (computer-repair)", "Business: Printing Services (print-shops)", "Business: Property Management Companies (property-management)", "Business: Private Investigators (private-investigators)", "Business: Advertising Agencies (advertising-agencies)", "Business: Office Cleaning Services (office-cleaning)", "Business: Digital Marketing Agencies (digital-marketing-agencies)", "Business: Screen Printing Services (screen-printing-tshirts)", "Business: PR Firms (public-relations-firms)", "Business: Courier Services (courier-services)", "Business: Employment Agencies (employment-staffing-agencies)", "Business: Business Consultants (business-consultants)", "Business: Marketing Consultants (marketing-consultants)", "Business: Pay-Per-Click (PPC) Agencies (ppc-agencies)", "Business: Branding Agencies (branding-agencies)", "Business: SEO Agencies (seo-agencies)", "Business: Mobile App Developers (mobile-app-development)", "Business: Content Marketing Agencies (content-marketing-agencies)", "Business: Internet Providers (internet-providers)", "Business: Graphic Designers (graphic-designers)", "Business: Social Media Marketing Agencies (social-media-marketing)", "Business: Managed IT Service Providers (managed-service-providers)", "Business: Web Designers (web-design)", "Business: Voice Actors (voice-actors)", "Business: Structural Engineers (structural-engineers)", "Business: UX/UI Design Agencies (user-experience)", "Business: Web Developers (web-developers)", "Business: Software Development Companies (software-development)", "Business: Trade Schools (trade-schools)", "Business: Legal Marketing Companies (law-firm-marketing)", "Business: Non-Profit and Government Marketing Agencies (non-profit-and-government-marketing-agency)", "Business: Database Services Providers (database-services)" ] } }, "locations": { "title": "Locations", "type": "array", "description": "One per row. \"City, ST\" (Houston, TX), a state (\"Texas\" or \"TX\") for every list in that state, biggest cities first, or a city alone when the name is unique. Spellings such as St./Saint and Ft./Fort are matched to the site's own. With categories but no location, Houston, TX is searched; with a location but no category, Financial Advisors.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (Expertise.com pages)", "type": "array", "description": "Paste Expertise.com pages: a city list (…/finance/financial-advisors/texas/houston), a state list (…/legal/disability-lawyers/texas), a category page (…/home-improvement/plumbing = every list nationwide, biggest markets first), a city page (…/texas/houston = every category listed there) or a profile (…/profile/). In Search mode these are read in addition to the search.", "items": { "type": "string" } }, "urlsFromFile": { "title": "Import URLs from a file", "type": "string", "description": "Paste a list of Expertise.com URLs (one per line), or one link to a .txt/.csv file, Google Sheet or Google Drive file containing them." }, "maxResults": { "title": "Max results (businesses)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Cap on businesses for the whole run. It is shared fairly across every list the run reads, top-ranked businesses first, so many cities each get their share. A city list holds about 6-25 businesses.", "default": 100 }, "maxResultsPerList": { "title": "Max results per list (optional)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Keep only the top N businesses of each list (for example the top 5 in every city). Leave empty for no per-list limit." }, "excludeAds": { "title": "Skip sponsored rows", "type": "boolean", "description": "Skip the occasional sponsored row (a lead-marketplace ad or Expertise.com's own concierge line) so only real businesses are returned and billed.", "default": true }, "enhancedListingsOnly": { "title": "Only enhanced (claimed) listings", "type": "boolean", "description": "Only businesses on Expertise.com's enhanced (paid, claimed) listing tier - usually 0-2 per list, shown at the top.", "default": false }, "licensedOnly": { "title": "Only businesses with a licence number", "type": "boolean", "description": "Only businesses for which Expertise.com publishes a licence number (financial advisers, insurance agencies, real estate agents, movers and other regulated trades; legal and agency lists have none).", "default": false }, "withWebsiteOnly": { "title": "Only businesses with a website", "type": "boolean", "description": "Only businesses that list their own website (almost all do).", "default": false }, "withPhoneOnly": { "title": "Only businesses with a phone number", "type": "boolean", "description": "Only businesses that list a phone number.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only businesses with at least this star rating (0-5, decimals allowed such as 4.5). Unrated businesses are excluded when this is above 0.", "default": 0 }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "type": "integer", "description": "Only businesses with at least this many reviews across the review sites the list shows.", "default": 0 }, "enrichContactEmails": { "title": "Find e-mails on the business websites", "type": "boolean", "description": "Visit each business's own website (home, contact and about pages) for an e-mail address, phones and social profiles. Billed as \"Website e-mail\" only for businesses where a business e-mail is found; sites with nothing found cost nothing extra.", "default": false }, "withEmailOnly": { "title": "Only businesses with an e-mail", "type": "boolean", "description": "Only return businesses whose website shows a business e-mail address. Switches the website e-mail lookup on.", "default": false }, "deduplicateProviders": { "title": "Deduplicate businesses", "type": "boolean", "description": "Return each business once per run even when it appears on several lists (several cities or categories).", "default": true }, "monitorMode": { "title": "Monitoring mode: only new businesses", "type": "boolean", "description": "Remember each list. The first run returns the current lists; later runs return only businesses newly added to them. Pair it with an Apify Schedule.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that keeps the monitoring memory. Use a different name per tracked search to keep their histories apart (letters, digits and hyphens).", "default": "expertise-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Parallel requests (list pages and website lookups).", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Expertise.com works through the default Apify proxy; a refused request is retried on a new IP.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }