# Lawyers.com Scraper (`jungle_synthesizer/lawyers-com-scraper`) Actor Scrape attorney and law firm profiles from Lawyers.com. Extract names, firm info, contact details, practice areas, education, and peer endorsements. Filter by US state and legal practice area. - **URL**: https://apify.com/jungle\_synthesizer/lawyers-com-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Lead generation, Business, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ## Lawyers.com Attorney Directory Scraper Scrape attorney and law firm profiles from [Lawyers.com](https://www.lawyers.com/), one of the largest US legal directories. Returns names, firm info, phone numbers, websites, practice areas, ratings, review counts, and biographical details for attorneys across all 50 states and 30+ practice areas. --- ### Lawyers.com Scraper Features - Extracts 20+ fields per attorney or firm record including contact details, practice areas, and ratings - Filters by US state and legal practice area with 30 supported categories - Discovers city-level listing pages automatically from each state's directory - Deduplicates attorneys and firms across overlapping city and practice area results - Handles Cloudflare protection with browser-based scraping and residential proxies - Outputs to JSON, CSV, or the Apify API --- ### Who Uses Lawyers.com Data? - **Legal marketing firms** -- Build targeted attorney outreach lists filtered by state, city, and practice area - **CRM enrichment** -- Populate contact databases with verified firm names, phone numbers, websites, and ratings - **Market analysis** -- Measure attorney density by geography and specialty to identify underserved markets - **Lead qualification** -- Filter attorneys by review count, average rating, and free consultation availability - **Competitive research** -- Track how firms position themselves across practice areas and geographic markets --- ### How the Lawyers.com Scraper Works 1. **Configure filters** -- Select one or more US states and optionally narrow by practice area 2. **City discovery** -- The scraper visits each state's city directory page and collects city-level listing URLs 3. **Listing extraction** -- Each city listing page is scraped for firm cards containing attorney names, contact info, ratings, and practice summaries. Pagination is handled automatically. 4. **Export** -- Deduplicated results land in the Apify dataset for download or API access --- ### Input ```json { "maxItems": 100, "states": ["TX", "CA"], "practiceAreas": ["personal-injury"], "maxPagesPerCity": 5 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | maxItems | integer | `100` | Maximum number of attorney records to scrape. Required. | | states | string\[] | all states | US state codes to filter results (e.g., `["TX", "CA", "NY"]`). Leave empty to scrape all states. | | practiceAreas | string\[] | all areas | Legal practice areas to filter (e.g., `["personal-injury", "family-law"]`). Leave empty for all. | | maxPagesPerCity | integer | `5` | Maximum listing pages to crawl per city before moving on. Each page has about 30 results. | | proxyConfiguration | object | US Residential | Proxy settings. Lawyers.com uses Cloudflare, so residential proxies are required. | #### Supported Practice Areas Personal Injury, Criminal Law, Family Law, Divorce, Bankruptcy, Real Estate, Business Law, Civil Litigation, Labor and Employment, Wills and Probate, Immigration, Medical Malpractice, Workers Compensation, Child Custody, DUI/DWI, Estate Planning, Intellectual Property, Tax Planning, Traffic Violations, Wrongful Termination, Small Business Law, Insurance, Construction Law, Elder Law, Social Security Disability, General Practice, Corporate Law, Environmental Law, Securities, Trusts and Estates. *** ### Lawyers.com Scraper Output Fields ```json { "attorney_id": "12345678", "name": "John Smith", "first_name": "John", "last_name": "Smith", "firm_name": "Smith & Associates, PLLC", "title": null, "city": "Houston", "state": "TX", "location": "Houston, TX", "street_address": null, "zip": "77002", "phone": "(713) 555-0199", "website": "https://www.smithlegal.com", "practice_areas": "Car Accidents, Brain Injury, Wrongful Death", "years_experience": null, "education": null, "bar_admissions": null, "peer_endorsements_count": null, "client_reviews_count": 42, "average_rating": 4.7, "bio_snippet": "Aggressive representation for personal injury victims across Texas", "profile_url": "https://www.lawyers.com/houston/texas/john-smith-12345678-a/", "source_page": "https://www.lawyers.com/personal-injury/houston/texas/law-firms/" } ``` | Field | Type | Description | |-------|------|-------------| | attorney\_id | string | Unique attorney identifier extracted from profile URL | | name | string | Attorney full name | | first\_name | string | First name | | last\_name | string | Last name | | firm\_name | string | Law firm name | | title | string | Professional title (e.g., Partner, Associate) | | city | string | City where the attorney is located | | state | string | Two-letter US state code | | location | string | Full location string (city, state) | | street\_address | string | Street address of the firm | | zip | string | Postal code | | phone | string | Attorney or firm phone number | | website | string | Attorney or firm website URL | | practice\_areas | string | Comma-separated list of legal practice areas | | years\_experience | number | Years of legal experience (when listed) | | education | string | Comma-separated list of degrees and schools | | bar\_admissions | string | Comma-separated list of bar admissions | | peer\_endorsements\_count | number | Number of peer endorsements from other attorneys | | client\_reviews\_count | number | Number of client reviews | | average\_rating | number | Average client rating (0-5 scale) | | bio\_snippet | string | Short biography excerpt from the listing | | profile\_url | string | Full URL to attorney profile on Lawyers.com | | source\_page | string | URL of the listing page this record was scraped from | *** ### FAQ #### How do I scrape attorney data from Lawyers.com? The Lawyers.com Scraper handles it. Set one or more US states, optionally filter by practice area, and configure your maxItems limit. The scraper discovers cities within each state, paginates through listing pages, and extracts attorney and firm records. #### How much does the Lawyers.com Scraper cost to run? The Lawyers.com Scraper uses pay-per-event pricing: $0.10 per actor start plus $0.001 per record. A 100-attorney run costs roughly $0.20. Residential proxy usage scales with the number of pages visited. #### Can I scrape all 50 states at once? Yes. Leave the states field empty and the Lawyers.com Scraper will iterate through every state. Set a reasonable maxItems limit -- the directory is large, and an uncapped run across all states will take a while and consume significant proxy bandwidth. #### What practice areas does the Lawyers.com Scraper support? The Lawyers.com Scraper supports 30 practice areas including Personal Injury, Criminal Law, Family Law, Divorce, Bankruptcy, Real Estate, Immigration, and more. Pass the practice area slugs in the practiceAreas input field, or leave it empty to scrape all categories. #### Does the Lawyers.com Scraper need proxies? Yes. Lawyers.com uses Cloudflare protection, so US residential proxies are required. The actor configures these automatically through Apify's proxy infrastructure. *** ### Need More Features? Need additional fields, profile-level detail pages, or a scraper for a different legal directory? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use the Lawyers.com Scraper? - **Broad coverage** -- 50 states, 30+ practice areas, and automatic city discovery so you do not have to manually build URL lists - **Deduplicated** -- Attorneys and firms appearing across multiple cities or practice areas are tracked and emitted once - **Affordable** -- Pay-per-event pricing at $0.001 per record with no subscription or minimum commitment # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `maxItems` (type: `integer`): Maximum number of attorney records to scrape. Required. Keep low for first runs. ## `states` (type: `array`): US state codes to filter results (e.g. \["TX", "CA", "NY"]). Leave empty to scrape all states. ## `practiceAreas` (type: `array`): Legal practice areas to filter results. Leave empty for all practice areas. ## `maxPagesPerCity` (type: `integer`): Maximum listing pages to crawl per city before moving on. Default is 5. ## `proxyConfiguration` (type: `object`): Proxy settings. Lawyers.com uses Cloudflare protection, so residential proxies are required. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 100, "states": [ "TX" ], "maxPagesPerCity": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 100, "states": [ "TX" ], "maxPagesPerCity": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/lawyers-com-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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 100, "states": ["TX"], "maxPagesPerCity": 5, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/lawyers-com-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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 100, "states": [ "TX" ], "maxPagesPerCity": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call jungle_synthesizer/lawyers-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/lawyers-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Lawyers.com Scraper", "description": "Scrape attorney and law firm profiles from Lawyers.com. Extract names, firm info, contact details, practice areas, education, and peer endorsements. Filter by US state and legal practice area.", "version": "1.0", "x-build-id": "yd42fOBybu9ycbUU0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~lawyers-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-lawyers-com-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/jungle_synthesizer~lawyers-com-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-lawyers-com-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/jungle_synthesizer~lawyers-com-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-lawyers-com-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": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of attorney records to scrape. Required. Keep low for first runs.", "default": 100 }, "states": { "title": "States", "type": "array", "description": "US state codes to filter results (e.g. [\"TX\", \"CA\", \"NY\"]). Leave empty to scrape all states.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "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" ] } }, "practiceAreas": { "title": "Practice Areas", "type": "array", "description": "Legal practice areas to filter results. Leave empty for all practice areas.", "items": { "type": "string", "enum": [ "personal-injury", "criminal-law", "family-law", "divorce", "bankruptcy", "real-estate", "business-law", "civil-litigation", "labor-and-employment", "wills-and-probate", "immigration", "medical-malpractice", "workers-compensation", "child-custody", "dui-dwi", "estate-planning", "intellectual-property", "tax-planning", "traffic-violations", "wrongful-termination", "small-business-law", "insurance", "construction-law", "elder-law", "social-security-disability", "general-practice", "corporate-law", "environmental-law", "securities", "trusts-and-estates" ], "enumTitles": [ "Personal Injury", "Criminal Law", "Family Law", "Divorce", "Bankruptcy", "Real Estate", "Business Law", "Civil Litigation", "Labor and Employment", "Wills and Probate", "Immigration", "Medical Malpractice", "Workers Compensation", "Child Custody", "DUI/DWI", "Estate Planning", "Intellectual Property", "Tax Planning", "Traffic Violations", "Wrongful Termination", "Small Business Law", "Insurance", "Construction Law", "Elder Law", "Social Security Disability", "General Practice", "Corporate Law", "Environmental Law", "Securities", "Trusts and Estates" ] } }, "maxPagesPerCity": { "title": "Max pages per city", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum listing pages to crawl per city before moving on. Default is 5.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Lawyers.com uses Cloudflare protection, so residential proxies are required." } } }, "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 } } } } } } } } } } ```