# Avvo Scraper - US Attorney Directory & Lawyer Leads (`scrapesage/avvo-scraper`) Actor Scrape Avvo lawyer profiles: Avvo Rating, client reviews, peer endorsements, bar admissions, practice areas, awards, disciplinary status, firm website & phone. Optional email enrichment & lead score. Search by practice area, city or URL. Export JSON, CSV, Excel. - **URL**: https://apify.com/scrapesage/avvo-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Avvo Scraper — US Attorney Directory & Lawyer Leads (Ratings, Reviews & Emails) Extract **complete Avvo attorney profiles** — the data other scrapers leave empty: the proprietary **Avvo Rating (1–10)**, **client reviews & peer endorsements**, **bar admissions with admission dates**, **practice areas**, **awards & honors**, **disciplinary/license status**, and **firm website, phone & socials**. Optionally turn every attorney into a **ready-to-contact B2B lead** by crawling their firm website for **emails, phone numbers and extra social links**. No login, no cookies, no API key — fast server-rendered HTML + JSON-LD extraction. ### Why this Avvo scraper? Avvo is the **largest US attorney directory** — millions of lawyer profiles across every practice area. Most scrapers only grab the name and a phone number. This actor pulls the full profile (JSON-LD + the rendered page) and ships the **richest lawyer dataset in the category**: | Data | Typical scrapers | This actor | |---|---|---| | Avvo Rating (1–10) + label (Superb / Excellent…) | ❌ | ✅ | | Client review count & average rating | partial | ✅ | | Peer endorsements & legal answers | ❌ | ✅ | | Bar license(s) + state + **admission date** + years licensed | ❌ | ✅ | | Disciplinary / "no misconduct found" status | ❌ | ✅ | | Practice areas, languages, bar associations | partial | ✅ | | Awards & honors (full list, with years) | ❌ | ✅ | | Firm website, LinkedIn, Facebook, Twitter | ❌ | ✅ | | Firm **contact emails** (from their website) | ❌ | ✅ opt-in | | Full address + geo (lat/lng) | partial | ✅ | | Payment methods, free-consultation flag, fees | ❌ | ✅ | | Lead score (0–100) per attorney | ❌ | ✅ | ### Use cases - **Legal lead generation** — attorneys are high-value buyers: they need legal marketing, case-management software, malpractice insurance, lead networks, billing, virtual receptionists and CLE. Score leads by `avvoRating`, `reviewCount`, `awards` and contactability (`phone`, `website`, `enrichedEmails`). - **Recruiting & legal staffing** — find lawyers by practice area, location, years licensed and credentials. - **Market & competitive intelligence** — map attorney supply by city and practice area; benchmark ratings, reviews and endorsements. - **M&A / law-firm rollups** — build target lists of firms and solo practitioners by geography and specialty. - **Directory & data enrichment** — append Avvo Rating, reviews and bar admissions to an existing attorney database. ### 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 **Avvo Scraper**, enter practice areas and locations (or paste Avvo URLs), 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": ["Austin, TX", "Los Angeles, CA"], "practiceAreas": ["personal injury", "divorce"], "maxResults": 100, "includeProfileDetails": true, "enrichEmails": true, "minAvvoRating": 8, "monitorMode": false } ```` - **locations** — `City, ST` (`Austin, TX`), the raw `st/city` slug (`tx/austin`), or a whole state (`Texas`, `CA`). Combined with every practice area. - **practiceAreas** — friendly terms (`divorce`, `personal injury`, `criminal defense`) or exact Avvo slugs (`divorce-lawyer`, `personal-injury-lawyer`, `dui-lawyer`, `estate-planning-lawyer`, `bankruptcy-lawyer`, `employment-lawyer`, `immigration-lawyer`, `business-lawyer`, `real-estate-lawyer`, `tax-lawyer`, `medical-malpractice-lawyer`, `workers-compensation-lawyer`). Empty or `all-lawyers` = every attorney in each location. - **startUrls** — direct Avvo URLs: attorney profiles (`/attorneys/…-1900396.html`) or directory listings (`/divorce-lawyer/tx/austin.html`). - **maxResults** *(default 100)* — total attorney cap across all searches. - **includeProfileDetails** *(default true)* — fetch each profile page for the full record. Off = lighter, listing-level fields only. - **enrichEmails** *(default false)* — crawl each firm website (home + contact/about, max 3 pages) for emails, phones and extra socials. Avvo never exposes emails — this is the only way to get them. - **minAvvoRating / minReviews / withPhoneOnly / withWebsiteOnly** — quality filters. - **monitorMode** *(default false)* — emit only attorneys not seen in previous runs (see below). - **proxyConfiguration** *(default Residential US)* — required; Avvo blocks datacenter IPs. ### Output One record per attorney: ```json { "attorneyId": "1900396", "name": "Robert Carl Frazer", "headline": "Divorce Lawyer", "jobTitle": "Attorney", "profileUrl": "https://www.avvo.com/attorneys/78731-tx-robert-frazer-1900396.html", "avvoRating": 10, "avvoRatingLabel": "Superb", "clientReviewRating": 5, "reviewCount": 16, "peerEndorsements": 38, "legalAnswers": 2, "awards": ["Super Lawyer - 2026", "Best Lawyers in America - 2020", "Board Certified - Family Law - 2018"], "awardCount": 17, "licenseStatus": "No misconduct found", "hasDisciplinaryRecord": false, "yearsLicensed": 17, "admissionDate": "2009-11-06", "primaryState": "Texas", "barStates": ["Texas"], "licenses": [{ "type": "State Bar License", "state": "Texas", "bar": "State Bar of Texas", "admissionDate": "2009-11-06" }], "practiceAreas": ["Family", "Child Custody", "Divorce & Separation"], "languages": ["English"], "associations": ["Austin Bar Association", "Capital Area Trial Lawyers Association"], "bio": "Rob Frazer is a top Austin divorce lawyer and partner at Goranson Bain Ausley…", "firmName": "Goranson Bain Ausley", "phone": "+1 (866) 935-6793", "website": "https://www.gbfamilylaw.com/attorney/rob-frazer/", "linkedin": "https://www.linkedin.com/in/rob-frazer-5137ba11", "street": "3307 Northland Drive, Suite 420", "city": "Austin", "state": "TX", "postalCode": "78731", "latitude": 30.334834, "longitude": -97.757593, "freeConsultation": true, "paymentMethods": ["Cash", "Check", "Credit Card"], "enrichedEmails": ["info@gbfamilylaw.com"], "leadScore": 92, "searchPracticeArea": "divorce-lawyer", "searchLocation": "Austin, TX", "scrapedAt": "2026-06-24T01:05:25.466Z" } ``` ### Monitor mode — only new attorneys Turn on **monitorMode** to get a steady feed of *new* leads instead of the same list every run. The actor remembers every attorney ID it has returned (in a named key-value store) and emits only attorneys it hasn't seen before. This **does not conflict with Apify Schedules** — they work together. The [Schedule](https://docs.apify.com/platform/schedules) triggers the run on your cadence (hourly/daily/weekly); monitor mode deduplicates that run's records against everything earlier runs already returned. 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 **[Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly to monitor new attorneys in a city or practice area; 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/avvo-scraper').call({ locations: ['Austin, TX'], practiceAreas: ['personal injury'], maxResults: 100, 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. 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 top-rated personal injury lawyers in Austin and list their firm contacts" and let it run this scraper for you. ### Agent-ready: autonomous payments (x402 & Skyfire) This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards: - **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key. - **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows. Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes. ### More scrapers from scrapesage Build a complete **legal & B2B lead-gen stack**: - **[Super Lawyers Scraper](https://apify.com/scrapesage/superlawyers-scraper)** — peer-rated top attorneys. - **[FindLaw Scraper](https://apify.com/scrapesage/findlaw-scraper)** — FindLaw attorney directory leads. - **[Expertise.com Scraper](https://apify.com/scrapesage/expertise-scraper)** — curated "best of" local pros, including lawyers. - **[Three Best Rated Scraper](https://apify.com/scrapesage/three-best-rated-scraper)** — top-3 hand-picked local businesses & lawyers. - **[Court Records Scraper](https://apify.com/scrapesage/court-records-scraper)** — federal/state court case data. - **[TaxBuzz Scraper](https://apify.com/scrapesage/taxbuzz-scraper)** — tax & accounting professional leads. - **[Texas Business Leads Scraper](https://apify.com/scrapesage/texas-business-leads-scraper)** — TX business registry leads. - **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — emails, phones & socials from any website. ### Tips - **Exhaust a market**: split big cities by practice area (one run per `personal-injury-lawyer`, `car-accident-lawyer`, etc.) and Avvo's per-listing pagination will surface far more attorneys than a single `all-lawyers` sweep. - **Highest-quality leads**: set `minAvvoRating: 8` and `minReviews: 5` to keep only well-established attorneys. - **Emails**: turn on `enrichEmails` to pull contact emails from firm websites — only runs for attorneys that actually have a website. - **Cost control**: keep `includeProfileDetails` on for the rich record; turn it off for a fast name/firm/phone-only sweep. - **Proxies**: keep the default Residential US proxy — Avvo blocks datacenter IPs. ### FAQ **How do I scrape Avvo lawyers for a specific city and practice area?** Put the city in `locations` (`Austin, TX`) and the area in `practiceAreas` (`divorce`, `personal injury`, or the exact slug `divorce-lawyer`). Every location is combined with every practice area. **Does it work without the Avvo API?** Yes. Avvo has no public API — this actor extracts data from public profile and listing pages (server-rendered HTML + JSON-LD), no key or login needed. **Where do the emails come from?** Never from Avvo (they don'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 on each run?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules). The actor remembers everything it returned before and emits only new attorneys. **A field is null — why?** Some attorneys genuinely don't publish a website, fees, or languages. Fields are `null` only when the data doesn't exist, not because the scraper skipped them. **Is scraping Avvo 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 Avvo'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. Use City, ST (Austin, TX, New York, NY, Los Angeles, CA), the raw st/city slug (tx/austin), or a whole state (Texas, CA). Each location is combined with every practice area below. ## `practiceAreas` (type: `array`): Practice areas to scrape, combined with every location. Use a friendly term (divorce, personal injury, criminal defense) or the exact Avvo slug (divorce-lawyer, personal-injury-lawyer, dui-lawyer, estate-planning-lawyer, bankruptcy-lawyer, employment-lawyer, immigration-lawyer, business-lawyer, real-estate-lawyer, tax-lawyer, medical-malpractice-lawyer, workers-compensation-lawyer). Leave empty or use all-lawyers for every attorney in each location. ## `startUrls` (type: `array`): Direct Avvo URLs: attorney profiles (https://www.avvo.com/attorneys/78731-tx-robert-frazer-1900396.html) or directory listings (https://www.avvo.com/divorce-lawyer/tx/austin.html). 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: bio, Avvo Rating, client reviews, peer endorsements, bar admissions + admission date, practice areas, awards, disciplinary status, firm website & socials, languages and payment info. Turn off for a faster, lighter run that returns only the listing-level fields (name, firm, address, phone, schools). ## `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. Avvo itself never exposes emails — this is the only way to get them. Requires profile details. ## `minAvvoRating` (type: `integer`): Only keep attorneys whose numeric Avvo Rating is at least this value (e.g. 8 for Excellent+). 0 = no minimum. Requires profile details. ## `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 profile pages to fetch in parallel. 5 is a safe default for residential proxies. ## `proxyConfiguration` (type: `object`): Proxies to use. A RESIDENTIAL US proxy is REQUIRED — Avvo blocks datacenter and direct requests but serves clean pages to residential US IPs. ## Actor input object example ```json { "locations": [ "Austin, TX" ], "practiceAreas": [ "personal injury" ], "maxResults": 100, "includeProfileDetails": true, "enrichEmails": false, "minAvvoRating": 0, "minReviews": 0, "withPhoneOnly": false, "withWebsiteOnly": false, "monitorMode": false, "monitorStoreName": "avvo-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": [ "Austin, TX" ], "practiceAreas": [ "personal injury" ], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/avvo-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": ["Austin, TX"], "practiceAreas": ["personal injury"], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/avvo-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": [ "Austin, TX" ], "practiceAreas": [ "personal injury" ], "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call scrapesage/avvo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/avvo-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Avvo Scraper - US Attorney Directory & Lawyer Leads", "description": "Scrape Avvo lawyer profiles: Avvo Rating, client reviews, peer endorsements, bar admissions, practice areas, awards, disciplinary status, firm website & phone. Optional email enrichment & lead score. Search by practice area, city or URL. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "rBcoGlqsZOgw1DxY0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~avvo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-avvo-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~avvo-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-avvo-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~avvo-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-avvo-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. Use City, ST (Austin, TX, New York, NY, Los Angeles, CA), the raw st/city slug (tx/austin), or a whole state (Texas, CA). Each location is combined with every practice area below.", "items": { "type": "string" } }, "practiceAreas": { "title": "Practice areas", "type": "array", "description": "Practice areas to scrape, combined with every location. Use a friendly term (divorce, personal injury, criminal defense) or the exact Avvo slug (divorce-lawyer, personal-injury-lawyer, dui-lawyer, estate-planning-lawyer, bankruptcy-lawyer, employment-lawyer, immigration-lawyer, business-lawyer, real-estate-lawyer, tax-lawyer, medical-malpractice-lawyer, workers-compensation-lawyer). Leave empty or use all-lawyers for every attorney in each location.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Avvo URLs: attorney profiles (https://www.avvo.com/attorneys/78731-tx-robert-frazer-1900396.html) or directory listings (https://www.avvo.com/divorce-lawyer/tx/austin.html). 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: bio, Avvo Rating, client reviews, peer endorsements, bar admissions + admission date, practice areas, awards, disciplinary status, firm website & socials, languages and payment info. Turn off for a faster, lighter run that returns only the listing-level fields (name, firm, address, phone, schools).", "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. Avvo itself never exposes emails — this is the only way to get them. Requires profile details.", "default": false }, "minAvvoRating": { "title": "Minimum Avvo Rating (1–10)", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only keep attorneys whose numeric Avvo Rating is at least this value (e.g. 8 for Excellent+). 0 = no minimum. Requires profile details.", "default": 0 }, "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": "avvo-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many profile pages to fetch in parallel. 5 is a safe default for residential proxies.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to use. A RESIDENTIAL US proxy is REQUIRED — Avvo 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 } } } } } } } } } } ```