# Attorney Database & Lawyer Directory Data — Avvo Scraper (`jungle_synthesizer/avvo-scraper`) Actor Build an attorney database, lawyer directory, or lawyer contact list from Avvo.com. A lawyer lead scraper and attorney lead scraper: names, address, phone, website, Avvo ratings, reviews, endorsements, practice areas, bar admissions, fees, and discipline. Filter by US state and practice area. - **URL**: https://apify.com/jungle_synthesizer/avvo-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Lead generation, Business, Other - **Features:** Limited permissions - **Stats:** 193 total users, 10 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 record scrapeds 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Avvo Attorney Directory Scraper Scrape attorney profiles from [Avvo.com](https://www.avvo.com), the largest US lawyer directory. Returns 25+ fields per profile — Avvo ratings, client reviews, peer endorsements, practice areas, bar admissions, fees, and contact information across all 50 states and 30 practice areas. *** ### Avvo Scraper Features - Extracts 25+ fields per attorney profile including Avvo's proprietary 1-10 rating - Filter by any combination of US states and legal practice areas - Scrape specific attorney profile URLs directly, or pull an entire state in one run - Collects fee transparency data: free consultations, contingency arrangements, hourly rates - Optional client review extraction with configurable depth per attorney - Minimum review rating and review count filters, so a lead list holds only well-reviewed attorneys - Every record comes back complete in one pass: no separate "fetch details" switch, and several states and practice areas in a single run - No fixed per-run record cap: `maxItems` has no maximum, so one run can return a whole state - Returns bar admissions, peer endorsements, and disciplinary records — the details most directories leave out - Bulk-capable: tens of thousands of profiles in a single run, with no per-profile wait *** ### Who Uses Avvo Attorney Data? - **Legal marketing agencies** — Build targeted outreach lists filtered by state, practice area, and rating - **Legal tech platforms** — Feed attorney profiles into directories, comparison tools, or matching services - **Compliance teams** — Screen attorneys for disciplinary actions and verify bar admissions - **Market researchers** — Analyze attorney density, pricing patterns, and review sentiment across jurisdictions - **Recruiting firms** — Identify experienced attorneys by years of practice, specialization, and peer endorsements *** ### How the Avvo Scraper Works 1. **Configure filters** — Pick states, practice areas, or paste specific attorney URLs. Leave filters empty to scrape everything, which is ambitious but supported. 2. **Match** — Your filters resolve against an indexed database of 1.6M Avvo attorney profiles. 3. **Profile data** — Each matching attorney is returned as a structured record. Reviews are included if enabled. 4. **Export** — Results land in your Apify dataset as clean JSON. Set `maxItems` to control how many profiles you need. *** ### Input #### Scrape by state and practice area ```json { "states": ["CA", "NY"], "practiceAreas": ["personal-injury", "criminal-defense"], "maxItems": 200 } ``` #### Scrape specific attorney profiles ```json { "attorneyUrls": [ "https://www.avvo.com/attorneys/15228-pa-heather-schmidtbresnahan-557591.html", "https://www.avvo.com/attorneys/92501-ca-william-bratton-296722.html" ], "maxItems": 2 } ``` #### Scrape well-reviewed attorneys only ```json { "states": ["FL"], "practiceAreas": ["personal-injury"], "minRating": 4.5, "minReviews": 10, "maxItems": 100 } ``` Attorneys with no client reviews are excluded when either floor is set. #### Scrape with reviews ```json { "states": ["TX"], "practiceAreas": ["divorce-and-separation"], "maxItems": 50, "includeReviews": true, "maxReviewsPerAttorney": 10 } ``` | Field | Type | Default | Description | |-----------------------|---------|--------------|-------------| | states | array | all states | One or more US state codes (e.g., `CA`, `NY`, `TX`). Leave empty to scrape all 50 states + DC. | | practiceAreas | array | all 30 areas | Filter by practice area slug (e.g., `personal-injury`, `bankruptcy`). Leave empty to scrape all 30 practice areas. | | attorneyUrls | array | — | Specific Avvo profile URLs. Looked up directly by profile ID when provided. | | maxItems | integer | 25 | Maximum attorney profiles to return. Set to 0 for unlimited. | | minRating | number | — | Only attorneys whose average client review rating (1-5 stars) is at least this value. Attorneys with no reviews are excluded. | | minReviews | integer | — | Only attorneys with at least this many client reviews. | | includeReviews | boolean | false | Scrape client reviews for each attorney. Adds run time. | | enrichEmails | boolean | false | Find the attorney's email on their own website and contact page. Only attorneys with a website can match. Each record that returns an email is billed one extra result. | | maxReviewsPerAttorney | integer | 10 | Cap on reviews per profile. Only applies when `includeReviews` is enabled. Range: 1-100. | | resumeCursor | string | — | Continue a previous run without paying again for records you already received: paste the `resumeCursor` from that run's Output and keep the same filters. Ignored for `attorneyUrls` lookups. | *** ### Avvo Scraper Output Fields ```json { "attorney_name": "William Paul Bratton", "first_name": "William", "last_name": "Bratton", "avvo_rating": 10, "avvo_rating_label": "Superb", "review_count": 87, "average_review_rating": 5, "endorsement_count": 42, "practice_areas": ["Divorce & Separation", "Family Law", "Child Custody"], "primary_practice_area": "Divorce & Separation", "years_of_experience": 28, "bar_admissions": ["California (1997)"], "address": "3801 University Ave Suite 560", "city": "Riverside", "state": "CA", "zip": "92501", "phone": "(951) 555-0142", "website": "https://brattonlawgroup.com", "email": null, "fee_free_consultation": true, "fee_contingency": false, "fee_hourly_rate": "$300 - $400 per hour", "languages": ["English", "Spanish"], "awards": ["Super Lawyers Rising Star", "Top 40 Under 40"], "disciplinary_action": false, "claimed_profile": true, "reviews": null, "profile_url": "https://www.avvo.com/attorneys/92501-ca-william-bratton-296722.html" } ``` | Field | Type | Description | |-----------------------|---------|-----------------------------------------------------------------------------------------------------| | attorney_name | string | Full attorney name | | first_name | string | Attorney first name | | last_name | string | Attorney last name | | avvo_rating | number | Avvo proprietary rating on a 1-10 scale | | avvo_rating_label | string | Rating label: Superb, Excellent, Very Good, Good, Average, or Concern | | review_count | number | Total number of client reviews | | average_review_rating | number | Average client review rating (1-5 stars) | | endorsement_count | number | Peer endorsements from other attorneys | | practice_areas | array | List of legal practice areas | | primary_practice_area | string | Primary or featured practice area | | years_of_experience | number | Total years of legal practice | | bar_admissions | array | Bar admissions with state and year | | address | string | Office street address | | city | string | Office city | | state | string | Office state (two-letter code) | | zip | string | Office ZIP code | | phone | string | Office phone number, formatted as (XXX) XXX-XXXX | | website | string | Attorney or firm website URL | | email | string | Attorney email from their own website, when `enrichEmails` is enabled and one is published | | fee_free_consultation | boolean | Whether the attorney offers a free initial consultation | | fee_contingency | boolean | Whether contingency fee arrangements are accepted | | fee_hourly_rate | string | Hourly rate or range, when disclosed | | languages | array | Languages spoken | | awards | array | Professional awards and recognitions | | disciplinary_action | boolean | Whether disciplinary actions are on record | | claimed_profile | boolean | Whether the attorney has claimed their Avvo profile | | reviews | array | Client reviews when `includeReviews` is enabled. Each formatted as: `rating stars \| title \| date` | | profile_url | string | Full Avvo profile URL | *** ### FAQ #### How do I scrape attorney profiles from Avvo? Avvo Scraper handles it. Set your state and practice area filters, configure `maxItems`, and run. Results come back as structured records, and there is no per-profile wait — a run asking for 10,000 attorneys finishes in about the time one asking for 10 does. You can also paste specific Avvo profile URLs if you already know which attorneys you need. #### How much does Avvo Scraper cost to run? Avvo Scraper uses pay-per-event pricing — you pay per attorney profile returned, not per request. A typical run scraping 200 profiles from a single state costs a few cents. Infrastructure is included in that price; there is no separate tier to configure. #### What data can I get from Avvo? Avvo Scraper returns 25+ fields per attorney profile. That covers the obvious ones — name, phone, website, address — and the ones that make Avvo worth scraping: the proprietary Avvo rating, peer endorsement counts, bar admission details, disciplinary records, fee structures, and client reviews. Most of this data isn't available from other legal directories. #### Can I filter attorneys by state or practice area? Avvo Scraper supports all 50 US states plus DC, and 30 practice areas from Divorce & Separation to Intellectual Property. You can combine multiple states and practice areas in a single run, narrow by minimum review rating and review count, or leave the filters empty to scrape across the entire directory. *** ### Need More Features? Need custom fields, different filters, or bulk export formats? [Open an issue](https://console.apify.com/actors/CdHk7IO8xrYvoKz34/issues) or get in touch. ### Why Use Avvo Scraper? - **25+ fields per profile** — Goes deeper than name and phone. Returns Avvo ratings, endorsements, bar admissions, disciplinary records, fee structures, and languages in one structured record. - **Clean output** — Every field has a consistent type and format. Phone numbers are formatted, arrays are arrays, booleans are booleans. No post-processing archaeology required. - **Filter or go wide** — Scrape a single practice area in one state, or leave the filters empty and pull from the entire US directory. The scraper handles the scope either way. *** **Further reading:** [How to Find Attorney Contact Data Without Paying ZoomInfo Prices](https://orbtop.com/articles/how-to-find-attorney-contact-data/) ### Related Actors - **[Attorney Contact List & Lawyer Directory Data — Justia](https://apify.com/jungle_synthesizer/justia-scraper)** — Build an attorney contact list or law firm database from Justia.com. - **[US Attorney Database & Lawyer Leads — Good Standing](https://apify.com/jungle_synthesizer/good-standing-us-attorney-database)** — Use this instead of Avvo profiles when you need bar-verified license status: a multi-state attorney database built from 16 state bar registries, with eligibility, disciplinary history and contact fields, for lawyer leads and attorney license verification. - **[Multi-State Bar Association Scraper](https://apify.com/jungle_synthesizer/multi-state-bar-scraper)** — Attorney records from official state bar websites across 21 U.S. states: bar number, status, admission date, discipline, firm and contact info. # Actor input Schema ## `sp_intended_usage` (type: `string`): What will this data feed? E.g. lead lists, KYB checks, price tracking. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): We'll personally help with your use case. No spam. ## `resumeCursor` (type: `string`): Leave empty for a fresh run. To CONTINUE a previous run without paying again for records you already received, paste the `resumeCursor` value from that run's Output (the run's OUTPUT key), with the same filters. It has no effect when you look up specific records. ## `states` (type: `array`): Select one or more U.S. states to scrape. Leave empty to scrape all states. ## `practiceAreas` (type: `array`): Filter by legal practice area. Leave empty to scrape all practice areas. ## `attorneyUrls` (type: `array`): Specific Avvo attorney profile URLs. Looked up directly by profile ID when provided. ## `maxItems` (type: `integer`): Maximum number of attorney profiles to scrape. Set to 0 for unlimited. ## `minRating` (type: `number`): Only return attorneys whose average client review rating (1-5 stars) is at least this value. Attorneys with no reviews are excluded. Leave empty for no floor. ## `minReviews` (type: `integer`): Only return attorneys with at least this many client reviews. Leave empty for no floor. ## `includeReviews` (type: `boolean`): Scrape detailed client reviews for each attorney. Increases run time but provides review text, ratings, and dates. Disabled by default. ## `enrichEmails` (type: `boolean`): Look for the attorney's email on their own website and contact page. Only attorneys with a website can match. Each record that returns an email is billed one extra result. ## `maxReviewsPerAttorney` (type: `integer`): Maximum number of client reviews to scrape per attorney profile (only applies when Include Reviews is enabled). ## Actor input object example ```json { "sp_contact": "Share your email here...", "states": [ "CA" ], "practiceAreas": [ "divorce-and-separation" ], "maxItems": 25, "includeReviews": false, "enrichEmails": false, "maxReviewsPerAttorney": 10 } ``` # 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_contact": "Share your email here...", "states": [ "CA" ], "practiceAreas": [ "divorce-and-separation" ], "maxItems": 25, "includeReviews": false, "enrichEmails": false, "maxReviewsPerAttorney": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/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 = { "sp_contact": "Share your email here...", "states": ["CA"], "practiceAreas": ["divorce-and-separation"], "maxItems": 25, "includeReviews": False, "enrichEmails": False, "maxReviewsPerAttorney": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/avvo-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).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_contact": "Share your email here...", "states": [ "CA" ], "practiceAreas": [ "divorce-and-separation" ], "maxItems": 25, "includeReviews": false, "enrichEmails": false, "maxReviewsPerAttorney": 10 }' | apify call jungle_synthesizer/avvo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,jungle_synthesizer/avvo-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/CdHk7IO8xrYvoKz34/builds/TmawQI5UGRbUHQN5H/openapi.json