# Avvo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for attorneys by location and specialty to find detailed professional profiles, reviews, and practice areas that match your legal needs. Browse community-driven legal Q&A to get answers to common legal questions and learn from other users' experiences.

**Category:** Business Directories | **Website:** [avvo.com/](https://avvo.com/) | **Docs:** [parse.bot/marketplace/72682e71-924b-49d3-83b5-5dac94814c26/avvo-com-api](https://parse.bot/marketplace/72682e71-924b-49d3-83b5-5dac94814c26/avvo-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-avvo-com-api-72682e71/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_attorney_profile

Retrieve full details for a specific attorney using their Avvo profile URL. Returns structured data including bio, practice areas, education, awards, and work experience. The URL is obtained from search_attorneys results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full Avvo attorney profile URL (e.g. 'https://www.avvo.com/attorneys/92660-ca-john-christl-4732017.html'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-avvo-com-api-72682e71/get_attorney_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_attorney_reviews

Retrieve client reviews for an attorney from their Avvo profile URL. Returns an array of reviews with ratings, header info, and review text. The URL is obtained from search_attorneys results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full Avvo attorney profile URL (e.g. 'https://www.avvo.com/attorneys/92660-ca-john-christl-4732017.html'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-avvo-com-api-72682e71/get_attorney_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### list_practice_areas

List all legal practice areas available on Avvo, organized alphabetically by letter. Each letter group contains practice area names and their corresponding URLs. No input parameters required. Returns the complete directory in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-avvo-com-api-72682e71/list_practice_areas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_attorneys

Search for attorneys by practice area and location. Returns a paginated list of matching attorneys with their Avvo rating, review count, and contact information. Pagination via page number; 20 results per page. When no filters are provided, returns all lawyers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City name (e.g. 'los angeles'). Requires state to also be provided. |
| `page` | integer | No | Page number for pagination. |
| `practice_area` | string | No | Practice area slug (e.g. 'criminal defense', 'family', 'bankruptcy'). Omitting returns all lawyers. |
| `sort` | string | No | Sort field. |
| `state` | string | No | US state abbreviation in lowercase (e.g. 'ca', 'tx'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-avvo-com-api-72682e71/search_attorneys \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>","practice_area":"<string>","sort":"<string>","state":"<string>"}'
```

### search_legal_qa

Search legal questions and answers on Avvo by keyword. Returns matching Q&A entries with titles and URLs linking to the full question and answer threads.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or question (e.g. 'speeding ticket', 'divorce custody'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-avvo-com-api-72682e71/search_legal_qa \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```