# Avvo Lawyer Directory API

> Lawyers on Avvo by practice area and state, with firm, address, phone, rating, reviews, practice areas, license and profile URL.

- Page: https://cleanedweb.com/catalog/avvo-lawyer-directory-api/
- Contract (JSON): https://cleanedweb.com/catalog/avvo-lawyer-directory-api/contract.json
- Source: avvo.com (https://www.avvo.com/)
- Category: Businesses & places
- Updated: 2026-11-20

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Bobby Shamuilian` |
| `currency` | string | `USD` |
| `rating` | number | `10` |
| `url` | string | `https://www.avvo.com/attorneys/91730-ca-bobby-shamuilian-4238373.html?pa=104` |
| `image_url` | string | `https://images.avvo.com/avvo/ugc/images/head_shot/standard/lawyer_bobby_shamuilian_4238373_1787728562.jpg` |
| `address_country` | string | `U.S.A` |
| `address_region` | string | `CA` |
| `award` | string | `Client Champion Award` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/avvo-lawyer-directory-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `search` (string \| array of string): Optional. Text for the site's search box. Leave it out to read everything.
- `has_free_consultation` (boolean): Filters by has free consultation.
- `lang` (string): Optional. Filters by lang. Options: lang (Arabic), lang (Armenian), lang (Farsi), lang (French), lang (Hebrew), lang (Korean), lang (Mandarin), lang (Russian), and 1 more in https://cleanedweb.com/catalog/avvo-lawyer-directory-api/contract.json.
- `specialty_names` (string): Optional. Filters by specialty names. Options: specialty_names (Litigation), specialty_names (Car Accidents), specialty_names (Wrongful Death), specialty_names (Employment & Labor), specialty_names (Business), specialty_names (Criminal Defense), specialty_names (Defective and Dangerous Products), specialty_names (Real Estate), and 133 more in https://cleanedweb.com/catalog/avvo-lawyer-directory-api/contract.json.
- `category` (string): Optional. Free text: any category the site serves, written with letters, digits, underscores and hyphens, up to 58 characters. A name the site does not serve is refused. Leave it out to use the default: personal-injury-lawyer. For example: personal-injury-lawyer, insurance-lawyer (Insurance), workers-compensation-lawyer (Workers Compensation), medical-malpractice-lawyer (Medical Malpractice), car-accident-lawyer (Car Accident), slip-and-fall-accident-lawyer (Slip and Fall Accident). Pattern: `^[A-Za-z0-9][A-Za-z\-_0-9]{0,57}$`.
- `location` (string, required): Free text: any location the site serves, written with letters, digits, underscores and hyphens, up to 32 characters. A name the site does not serve is refused. For example: ca, tx. Pattern: `^[A-Za-z0-9][A-Za-z\-_0-9]{0,31}$`.
- `sort` (string): Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order. Options: Best reviewed on Avvo (client_rating), Most reviewed on Avvo (most_reviewed), Years licensed: Most to least (most_experience), Years licensed: Least to most (least_experience).

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_27cb9d9295b4f7ca1a4ff06b/endpoints/generated_27cb9d9295b4f7ca1a4ff06b_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_27cb9d9295b4f7ca1a4ff06b/endpoints/generated_27cb9d9295b4f7ca1a4ff06b_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "location": "ca",
    "lang": "Arabic"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_27cb9d9295b4f7ca1a4ff06b/endpoints/generated_27cb9d9295b4f7ca1a4ff06b_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-19

The same changelog, as data, is in https://cleanedweb.com/catalog/avvo-lawyer-directory-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_27cb9d9295b4f7ca1a4ff06b`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Avvo.
