# Avvo — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/avvo/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/avvo/get-attorney-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/avvo/get-attorney-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/avvo/list-practice-areas \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/avvo/search-attorneys \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/avvo/search-legal-qa \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.