# 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

$6.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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 <code>City, ST</code> (<code>Austin, TX</code>, <code>New York, NY</code>, <code>Los Angeles, CA</code>), the raw <code>st/city</code> slug (<code>tx/austin</code>), or a whole state (<code>Texas</code>, <code>CA</code>). Each location is combined with every practice area below.

## `practiceAreas` (type: `array`):

Practice areas to scrape, combined with every location. Use a friendly term (<code>divorce</code>, <code>personal injury</code>, <code>criminal defense</code>) or the exact Avvo slug (<code>divorce-lawyer</code>, <code>personal-injury-lawyer</code>, <code>dui-lawyer</code>, <code>estate-planning-lawyer</code>, <code>bankruptcy-lawyer</code>, <code>employment-lawyer</code>, <code>immigration-lawyer</code>, <code>business-lawyer</code>, <code>real-estate-lawyer</code>, <code>tax-lawyer</code>, <code>medical-malpractice-lawyer</code>, <code>workers-compensation-lawyer</code>). Leave empty or use <code>all-lawyers</code> for every attorney in each location.

## `startUrls` (type: `array`):

Direct Avvo URLs: attorney profiles (<code>https://www.avvo.com/attorneys/78731-tx-robert-frazer-1900396.html</code>) or directory listings (<code>https://www.avvo.com/divorce-lawyer/tx/austin.html</code>). 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
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Austin, TX"
    ],
    "practiceAreas": [
        "personal injury"
    ],
    "maxResults": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// 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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Austin, TX"],
    "practiceAreas": ["personal injury"],
    "maxResults": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# 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
  }
}' |
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 <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/EGfwxO6zBjmsib5PG/builds/SVXs97cIEX1jfYL6h/openapi.json