# Avvo Lawyers & Attorney Leads Scraper (`scrapers_lat/avvo-lawyers-scraper`) Actor
Scrape US lawyer and attorney profiles: name, practice areas, law firm, full address, phone, Avvo rating, client reviews, years licensed, bar/license status and languages. Search by practice area or name across any city. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/avvo-lawyers-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Lead generation, Business, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $17.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
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 Lawyers & Attorney Leads Scraper
> Build clean lists of US lawyers and attorneys with firm, phone, full address, Avvo rating, client reviews, practice areas, years licensed and license status. Search by practice area or by name across any city and export ready-to-use lead data.
**๐ฅ [Input](https://apify.com/scrapers_lat/avvo-lawyers-scraper/input-schema) ยท ๐ค [Output](https://apify.com/scrapers_lat/avvo-lawyers-scraper/output-schema) ยท ๐ฐ [Pricing](https://apify.com/scrapers_lat/avvo-lawyers-scraper/pricing) ยท โถ๏ธ [Examples](https://apify.com/scrapers_lat/avvo-lawyers-scraper/examples)**
Contacts phone, firm & address
Ratings & reviews plus license & bar status
JSON / CSV / Excel output formats
### What you get
Each record is one attorney, ready for a CRM, an outreach list or a spreadsheet:
- **name**, **jobTitle** and **profileUrl**: who they are and a direct link
- **firmName**: the law firm they work for
- **primaryPractice** and **practiceAreas**: what they handle
- **avvoRating** and **avvoRatingLevel**: the overall score (1 to 10) and its label
- **reviewsRating** and **reviewsCount**: average client review score and how many reviews
- **yearsLicensed**, **licensedSince**, **licenseState**, **licenseStatus**, **barOrganization**: bar and license details
- **disciplined**: whether the attorney has been disciplined by a state licensing authority
- **phone**, **addressStreet**, **city**, **state**, **zip**, **country**: full contact and location
- **latitude** and **longitude**: map coordinates
- **languages**: languages the attorney speaks
- **priceRange** and **freeConsultation**: fees and whether a free consult is offered
- **lawSchools**, **topAward**, **awardsCount**, **website**: background and links
- **searchQuery**, **searchCity** and **observedAt**: how and when it was collected
### Who is it for
| Use case | Who benefits |
|---|---|
| Legal lead generation | Agencies and vendors selling to law firms |
| Recruiting | Legal recruiters sourcing attorneys by practice and city |
| Market research | Analysts mapping firms, specialties and coverage |
| Directories & apps | Builders enriching their own lawyer listings |
### How to use it
1. Add one or more **practice areas or lawyer names** (for example `personal injury`, `divorce`, or a specific name).
2. Add the **cities** to search, or leave empty to search nationwide.
3. Keep **Include full profile details** on for ratings, license status, practice areas and languages.
4. Set **Max Lawyers** and run. Export as JSON, CSV or Excel, or pull it through the Apify API.
### Frequently Asked Questions
**Can I search by name instead of practice area?**
Yes. Put a lawyer's name in the search field to find their profile, or a practice area to list many attorneys in a city.
**What does the Avvo rating mean?**
It is an overall score from 1 to 10 with a label such as Superb or Excellent. Client reviews are separate: `reviewsRating` is the average star score and `reviewsCount` is how many reviews were left.
**Do you only charge for real results?**
Yes. You are billed per attorney record returned. A run that finds nothing costs nothing.
**How fresh is the data?**
Every profile is read at run time, so each record reflects the attorney's current listing (see observedAt).
### Related scrapers
- [Google Maps Business Leads & Contacts Scraper](https://apify.com/scrapers_lat/google-maps-scraper)
- [California State Bar Attorney License Scraper](https://apify.com/scrapers_lat/california-state-bar-scraper)
- [NPPES NPI Healthcare Provider Data Scraper](https://apify.com/scrapers_lat/nppes-npi-scraper)
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for public platforms: finance, news, real estate, jobs, e-commerce and government data. Browse the full catalog or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with Avvo. It only accesses publicly available profile data. Use the results in accordance with the source's terms and applicable law.
# Actor input Schema
## `searchQueries` (type: `array`):
One or more searches. Use a practice area (for example 'personal injury', 'divorce', 'criminal defense', 'bankruptcy') or a lawyer's name. Each entry runs its own search.
## `cities` (type: `array`):
Cities to search in, for example 'Los Angeles, CA', 'Chicago' or 'Miami, FL'. Leave empty to search nationwide. Every city is combined with every search above.
## `withDetails` (type: `boolean`):
When on, each lawyer's profile is opened to add practice areas, Avvo rating, client reviews, years licensed, license status and languages. Turn off for a faster, lighter run.
## `maxLawyers` (type: `integer`):
Maximum number of lawyer profiles to collect across all searches.
## Actor input object example
```json
{
"searchQueries": [
"personal injury",
"divorce"
],
"cities": [
"Los Angeles, CA",
"New York, NY"
],
"withDetails": true,
"maxLawyers": 30
}
````
# 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 = {
"searchQueries": [
"personal injury"
],
"cities": [
"Los Angeles, CA"
],
"maxLawyers": 30
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/avvo-lawyers-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 = {
"searchQueries": ["personal injury"],
"cities": ["Los Angeles, CA"],
"maxLawyers": 30,
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/avvo-lawyers-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 '{
"searchQueries": [
"personal injury"
],
"cities": [
"Los Angeles, CA"
],
"maxLawyers": 30
}' |
apify call scrapers_lat/avvo-lawyers-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/avvo-lawyers-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Avvo Lawyers & Attorney Leads Scraper",
"description": "Scrape US lawyer and attorney profiles: name, practice areas, law firm, full address, phone, Avvo rating, client reviews, years licensed, bar/license status and languages. Search by practice area or name across any city. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "3UNaP55ntTQclCAdf"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~avvo-lawyers-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-avvo-lawyers-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/scrapers_lat~avvo-lawyers-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-avvo-lawyers-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/scrapers_lat~avvo-lawyers-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-avvo-lawyers-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": {
"searchQueries": {
"title": "Practice areas or lawyer names",
"type": "array",
"description": "One or more searches. Use a practice area (for example 'personal injury', 'divorce', 'criminal defense', 'bankruptcy') or a lawyer's name. Each entry runs its own search.",
"items": {
"type": "string"
}
},
"cities": {
"title": "Cities",
"type": "array",
"description": "Cities to search in, for example 'Los Angeles, CA', 'Chicago' or 'Miami, FL'. Leave empty to search nationwide. Every city is combined with every search above.",
"items": {
"type": "string"
}
},
"withDetails": {
"title": "Include full profile details",
"type": "boolean",
"description": "When on, each lawyer's profile is opened to add practice areas, Avvo rating, client reviews, years licensed, license status and languages. Turn off for a faster, lighter run.",
"default": true
},
"maxLawyers": {
"title": "Max Lawyers To Scrape",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Maximum number of lawyer profiles to collect across all searches."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```