# Martindale Scraper - Attorney & Law Firm Leads (`scrapesage/martindale-scraper`) Actor Scrape Martindale-Hubbell lawyer profiles: AV Preeminent Peer Review Rating, client reviews, practice areas, bar info, firm name, website & phone. Optional email enrichment & lead score. Search by city, practice area or URL. Export JSON, CSV, Excel. - **URL**: https://apify.com/scrapesage/martindale-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Automation, Other - **Stats:** 2 total users, 1 monthly users, 50.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $12.00 / 1,000 attorney leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Martindale Scraper — Attorney & Law Firm Leads (AV Preeminent Ratings, Reviews & Firm Contacts) Extract **complete Martindale-Hubbell attorney data** — including the field every law-firm marketer wants: the proprietary **Martindale-Hubbell Peer Review Rating** (the famous **AV Preeminent** seal), client reviews, practice areas, years licensed, full firm contacts and geo. Optionally turn every attorney into a **ready-to-contact B2B lead** by crawling their firm's own website for **emails, phone numbers and social links**. No login, no cookies, no browser — fast server-rendered extraction with a residential US proxy. ### Why this Martindale scraper? Martindale-Hubbell has rated and reviewed US lawyers since 1868, and its **AV Preeminent Peer Review Rating** is the gold standard of attorney prestige. Most directory scrapers ignore it. This actor ships the **richest dataset in the category** — the listing card data *and* the full profile, merged: | Data | Typical scrapers | This actor | |---|---|---| | Martindale-Hubbell **Peer Review Rating** + AV Preeminent badge | ❌ | ✅ | | Client review rating + review count | ❌ | ✅ | | Practice areas | partial | ✅ | | Firm name + **firm website** + socials | ❌ | ✅ | | All firm **phone numbers** + fax | partial | ✅ | | Full address + map **geo** (lat/lng) | ❌ | ✅ | | Years licensed / year admitted | ❌ | ✅ | | Law school | ❌ | ✅ | | Firm **contact emails** (from firm website) | ❌ | ✅ opt-in | | Lead score (0–100) per attorney | ❌ | ✅ | | Monitor mode — only NEW attorneys | ❌ | ✅ | ### Use cases - **Legal lead generation** — attorneys and law firms are active buyers: legal tech & SaaS, case-management/CRM, e-discovery, malpractice & cyber insurance, lending, marketing, court reporting, expert-witness and staffing vendors all sell to them. Score by authority (`isAVPreeminent`, `peerReviewRating`, `reviewCount`) and reach them directly (`phone`, `website`, `enrichedEmails`). - **Recruiting & business development** — find attorneys by city, practice area and seniority (`yearsLicensed`); build referral networks and lateral-hire lists. - **Market & competitive intelligence** — map the lawyer landscape of any city/practice, track AV Preeminent density and firm footprints. - **Co-counsel & referral sourcing** — pinpoint highly-rated specialists in a target market with verified firm contact data. - **CRM enrichment** — append Peer Review Ratings, firm sites and practice areas to an existing attorney list via direct profile URLs. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Martindale Scraper**, enter locations and (optionally) practice areas, and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "locations": ["Los Angeles, CA", "Houston, TX"], "practiceAreas": ["Personal Injury", "Family Law"], "maxResults": 100, "includeProfileDetails": true, "enrichEmails": false, "avPreeminentOnly": false, "monitorMode": false } ```` - **locations** — where to search, as `City, ST` (`Los Angeles, CA`, `Houston, TX`, `New York, NY`) or `City, State`. Each location is combined with every practice area. Martindale results are city-scoped, so city-level locations give the best coverage. - **practiceAreas** — filter by practice. Use a friendly term (`personal injury`, `family law`, `criminal defense`, `bankruptcy`, `estate planning`, `business law`, `real estate`, `immigration`, `divorce`, `DUI`, `employment`, `medical malpractice`, `tax`, `intellectual property`) or the exact Martindale name. Leave empty for **all** attorneys in each location. - **startUrls** — direct Martindale URLs: attorney profiles (`/attorney/...`) or a searchlight results page. Used in addition to the locations. - **maxResults** *(default 100)* — total attorney cap across all searches. - **includeProfileDetails** *(default true)* — fetch each profile for firm website & socials, all phones + fax, address + geo, practice areas, law school, price range, review aggregate, Peer Review Rating label and bio. Turn off for a faster, listing-only run. - **enrichEmails** *(default false)* — crawl each firm's own website (home + contact/about, up to 3 pages) for emails, phones and extra socials. Martindale never exposes emails — this is the only way to get them. - **minPeerRating** / **avPreeminentOnly** / **minReviews** / **withPhoneOnly** / **withWebsiteOnly** — quality filters. - **monitorMode** *(default false)* — emit only attorneys not seen in previous runs (see below). - **proxyConfiguration** — keep the default **RESIDENTIAL US** proxy; Martindale blocks datacenter IPs. ### Output One record per attorney: ```json { "attorneyId": "2065760", "name": "Laura J. Portillo", "headline": "Family Law", "jobTitle": "Of Counsel", "profileUrl": "https://www.martindale.com/attorney/laura-j-portillo-2065760/", "imageUrl": "https://www.martindale.com/LBM_Images/Lawyers/lawyer-laura-portillo-photo-5207906.png", "peerReviewRating": 5, "peerReviewRatingLabel": "AV Preeminent", "isAVPreeminent": true, "clientReviewRating": 4.9, "reviewCount": 18, "yearsLicensed": 17, "admissionYear": 2009, "practiceAreas": ["Family Law", "Divorce", "Child Custody"], "schools": ["Loyola Law School"], "bio": "Laura Portillo focuses her practice on complex family law matters …", "firmName": "Law Offices of Michael Jay Berger", "firmUrl": "https://www.martindale.com/organization/law-offices-of-michael-jay-berger-1612386/", "website": "https://www.bankruptcypower.com", "phone": "310-299-1935", "phones": ["310-299-1935", "424-600-4850"], "street": "9454 Wilshire Blvd, Suite 600", "city": "Los Angeles", "state": "CA", "postalCode": "90212", "latitude": 34.0668, "longitude": -118.3998, "priceRange": "Fixed Hourly Rates", "offersVideoCalls": true, "isSubscriber": true, "enrichedEmails": ["info@bankruptcypower.com"], "leadScore": 92, "searchPracticeArea": "Family Law", "searchLocation": "Los Angeles, CA", "scrapedAt": "2026-06-23T12:00:00.000Z" } ``` Fields are `null` only when the data genuinely doesn't exist (e.g. a free profile with no firm website), never because the scraper skipped them. ### Monitor mode — a steady feed of NEW attorneys Turn on **monitorMode** to make every run remember the attorney IDs it has already returned (in a named key-value store) and emit only **new** attorneys next time. Combined with [Apify Schedules](https://docs.apify.com/platform/schedules) this gives you a clean drip of fresh leads with no duplicates. It does **not** conflict with scheduling: the Schedule decides *when* the actor runs; monitor mode decides *which records* of that run are new. Use different `monitorStoreName` values to track independent searches separately. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily/weekly to monitor a city or practice area for new attorneys; perfect for lead pipelines. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/martindale-scraper').call({ locations: ['Los Angeles, CA'], practiceAreas: ['Personal Injury'], maxResults: 100, avPreeminentOnly: true, enrichEmails: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} attorney leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new attorney leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new attorneys. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. You can call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find AV Preeminent personal injury lawyers in Houston and list their firm contacts" and let it run this scraper for you. ### Build a complete US legal & B2B lead stack Pair this with my other directory & lead-gen scrapers: - **[Avvo Scraper](https://apify.com/scrapesage/avvo-scraper)** — Avvo Rating, client reviews & disciplinary status for the largest US attorney directory. - **[FindLaw Scraper](https://apify.com/scrapesage/findlaw-scraper)** — lawyers & law firms from FindLaw. - **[Super Lawyers Scraper](https://apify.com/scrapesage/superlawyers-scraper)** — Super Lawyers & Rising Stars selectees. - **[Expertise.com Scraper](https://apify.com/scrapesage/expertise-scraper)** — vetted local professionals across verticals. - **[Three Best Rated Scraper](https://apify.com/scrapesage/three-best-rated-scraper)** — top-3 hand-picked local businesses. - **[Court Records Scraper](https://apify.com/scrapesage/court-records-scraper)** — case & docket data. - **[TaxBuzz Scraper](https://apify.com/scrapesage/taxbuzz-scraper)** — accountants & tax professionals. - **[LinkedIn Company Scraper](https://apify.com/scrapesage/linkedin-company-scraper)** — firmographics for the firms you find. - **[Google Maps Scraper](https://apify.com/scrapesage/google-maps-scraper)** — local business leads with emails & phones. - **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — emails, phones & socials from any list of firm websites. ### Tips - **City-level locations** give the best coverage — Martindale results are city-scoped. To exhaust a metro, add several cities and/or split by practice area. - **AV Preeminent targeting**: set `avPreeminentOnly: true` for the highest-prestige attorneys only. - **Cost control**: turn off `includeProfileDetails` for a fast listing-only pass (name, firm, city, phone, peer-review stars, AV badge), then re-run with profile details on a filtered shortlist. - **Rate-limits**: keep the default residential proxy and a modest `maxConcurrency` (5). The actor automatically rotates to a fresh residential IP and retries on any Cloudflare challenge. ### FAQ **How do I scrape Martindale lawyers for a specific city?** Put the city in `locations` as `City, ST` (e.g. `Los Angeles, CA`). Add `practiceAreas` to narrow by specialty, or leave it empty for every attorney in that city. **What is the AV Preeminent Rating?** It's the top tier of the Martindale-Hubbell **Peer Review Rating** — lawyers rated by their peers for the highest levels of legal ability and ethical standards. This actor returns the rating label (`peerReviewRatingLabel`), the star value (`peerReviewRating`) and an `isAVPreeminent` flag. **Where do the emails come from?** Never from Martindale (it doesn't publish emails). With `enrichEmails` on, the actor visits the attorney's own firm website and extracts publicly listed contact emails — the same thing a human visitor would see. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I get only new attorneys over time?** Turn on `monitorMode` and run on a [Schedule](https://docs.apify.com/platform/schedules). Each run emits only attorneys not seen before. **A field is null — why?** Some attorneys genuinely don't publish a firm website, price range or reviews. Fields are `null` only when the data doesn't exist, not because the scraper skipped them. **Is scraping Martindale legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and Martindale's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `locations` (type: `array`): Where to search, as City, ST (Los Angeles, CA, Houston, TX, New York, NY) or City, State (Chicago, Illinois). Each location is combined with every practice area below. Martindale results are city-scoped, so city-level locations give the best coverage. A bare state (California) is accepted best-effort. ## `practiceAreas` (type: `array`): Practice areas to filter by, combined with every location. Use a friendly term (personal injury, family law, criminal defense, bankruptcy, estate planning, business law, real estate, immigration, divorce, DUI, employment, medical malpractice, workers compensation, tax, intellectual property) or the exact Martindale practice-area name. Leave empty for ALL attorneys in each location. ## `startUrls` (type: `array`): Direct Martindale URLs: attorney profiles (https://www.martindale.com/attorney/jane-doe-esq-1234567/) or a Martindale searchlight results page. Used in addition to the locations above. ## `maxResults` (type: `integer`): Maximum number of attorney records to scrape across all locations and practice areas. ## `includeProfileDetails` (type: `boolean`): Fetch each attorney's profile page for the full record: firm website & socials, all phone numbers + fax, full address + map geo, practice areas, law school, price range, client/peer review aggregate, the Peer Review Rating label and bio. Turn off for a faster, lighter run that returns only the listing-level fields (name, firm, city, phone, peer-review stars, AV Preeminent badge, bio snippet). ## `enrichEmails` (type: `boolean`): For each attorney that has a firm website, crawl it (home + contact/about, up to 3 pages) to extract contact emails, phone numbers and extra social links. Martindale itself never exposes emails — this is the only way to get them. Requires profile details. ## `minPeerRating` (type: `integer`): Only keep attorneys whose Martindale-Hubbell Peer Review star rating is at least this value (e.g. 4 for highly-rated). 0 = no minimum. ## `avPreeminentOnly` (type: `boolean`): Keep only attorneys who carry the top Martindale-Hubbell AV Preeminent Peer Review Rating (the highest tier). Great for premium B2B targeting. ## `minReviews` (type: `integer`): Only keep attorneys with at least this many client reviews. 0 = no minimum. Requires profile details. ## `withPhoneOnly` (type: `boolean`): Skip attorneys that have no phone number. ## `withWebsiteOnly` (type: `boolean`): Skip attorneys that have no firm website. Requires profile details. ## `monitorMode` (type: `boolean`): Remember attorney IDs returned in previous runs (in a named key-value store) and emit only NEW attorneys on each run. Perfect with Apify Schedules for a steady new-lead feed — it does not conflict with scheduling: the schedule triggers the run, monitor mode deduplicates this run's records against everything earlier runs already returned. ## `monitorStoreName` (type: `string`): Name of the key-value store that holds the seen-attorney memory for monitor mode. Use different names to track independent searches separately (lowercase letters, digits and hyphens only). ## `maxConcurrency` (type: `integer`): How many pages to fetch in parallel. 5 is a safe default for residential proxies; lower it if you hit rate-limits. ## `proxyConfiguration` (type: `object`): Proxies to use. A RESIDENTIAL US proxy is REQUIRED — Martindale's Cloudflare WAF blocks datacenter and direct requests but serves clean pages to residential US IPs. ## Actor input object example ```json { "locations": [ "Los Angeles, CA" ], "practiceAreas": [ "Family Law" ], "maxResults": 100, "includeProfileDetails": true, "enrichEmails": false, "minPeerRating": 0, "avPreeminentOnly": false, "minReviews": 0, "withPhoneOnly": false, "withWebsiteOnly": false, "monitorMode": false, "monitorStoreName": "martindale-monitor", "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): All scraped attorney lead records as JSON items in the default dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "locations": [ "Los Angeles, CA" ], "practiceAreas": [ "Family Law" ], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/martindale-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "locations": ["Los Angeles, CA"], "practiceAreas": ["Family Law"], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/martindale-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "locations": [ "Los Angeles, CA" ], "practiceAreas": [ "Family Law" ], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call scrapesage/martindale-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/martindale-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Martindale Scraper - Attorney & Law Firm Leads", "description": "Scrape Martindale-Hubbell lawyer profiles: AV Preeminent Peer Review Rating, client reviews, practice areas, bar info, firm name, website & phone. Optional email enrichment & lead score. Search by city, practice area or URL. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "e2qFfQn8fiPmaaTXp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~martindale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-martindale-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~martindale-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-martindale-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~martindale-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-martindale-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": { "locations": { "title": "Locations", "type": "array", "description": "Where to search, as City, ST (Los Angeles, CA, Houston, TX, New York, NY) or City, State (Chicago, Illinois). Each location is combined with every practice area below. Martindale results are city-scoped, so city-level locations give the best coverage. A bare state (California) is accepted best-effort.", "items": { "type": "string" } }, "practiceAreas": { "title": "Practice areas", "type": "array", "description": "Practice areas to filter by, combined with every location. Use a friendly term (personal injury, family law, criminal defense, bankruptcy, estate planning, business law, real estate, immigration, divorce, DUI, employment, medical malpractice, workers compensation, tax, intellectual property) or the exact Martindale practice-area name. Leave empty for ALL attorneys in each location.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Martindale URLs: attorney profiles (https://www.martindale.com/attorney/jane-doe-esq-1234567/) or a Martindale searchlight results page. Used in addition to the locations above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max attorneys", "minimum": 1, "type": "integer", "description": "Maximum number of attorney records to scrape across all locations and practice areas.", "default": 100 }, "includeProfileDetails": { "title": "Include full profile details", "type": "boolean", "description": "Fetch each attorney's profile page for the full record: firm website & socials, all phone numbers + fax, full address + map geo, practice areas, law school, price range, client/peer review aggregate, the Peer Review Rating label and bio. Turn off for a faster, lighter run that returns only the listing-level fields (name, firm, city, phone, peer-review stars, AV Preeminent badge, bio snippet).", "default": true }, "enrichEmails": { "title": "Enrich emails from the firm website", "type": "boolean", "description": "For each attorney that has a firm website, crawl it (home + contact/about, up to 3 pages) to extract contact emails, phone numbers and extra social links. Martindale itself never exposes emails — this is the only way to get them. Requires profile details.", "default": false }, "minPeerRating": { "title": "Minimum Peer Review Rating (0–5)", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only keep attorneys whose Martindale-Hubbell Peer Review star rating is at least this value (e.g. 4 for highly-rated). 0 = no minimum.", "default": 0 }, "avPreeminentOnly": { "title": "Only AV Preeminent attorneys", "type": "boolean", "description": "Keep only attorneys who carry the top Martindale-Hubbell AV Preeminent Peer Review Rating (the highest tier). Great for premium B2B targeting.", "default": false }, "minReviews": { "title": "Minimum client reviews", "minimum": 0, "type": "integer", "description": "Only keep attorneys with at least this many client reviews. 0 = no minimum. Requires profile details.", "default": 0 }, "withPhoneOnly": { "title": "Only attorneys with a phone number", "type": "boolean", "description": "Skip attorneys that have no phone number.", "default": false }, "withWebsiteOnly": { "title": "Only attorneys with a firm website", "type": "boolean", "description": "Skip attorneys that have no firm website. Requires profile details.", "default": false }, "monitorMode": { "title": "Monitor mode (only new attorneys)", "type": "boolean", "description": "Remember attorney IDs returned in previous runs (in a named key-value store) and emit only NEW attorneys on each run. Perfect with Apify Schedules for a steady new-lead feed — it does not conflict with scheduling: the schedule triggers the run, monitor mode deduplicates this run's records against everything earlier runs already returned.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Name of the key-value store that holds the seen-attorney memory for monitor mode. Use different names to track independent searches separately (lowercase letters, digits and hyphens only).", "default": "martindale-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages to fetch in parallel. 5 is a safe default for residential proxies; lower it if you hit rate-limits.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to use. A RESIDENTIAL US proxy is REQUIRED — Martindale's Cloudflare WAF blocks datacenter and direct requests but serves clean pages to residential US IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```