# Lawyers — 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 and discover lawyers and law firms with detailed profiles, client reviews, and practice area information. Find legal articles and featured firms by specialty to help you locate the right legal representation for your needs.

**Category:** Business Directories | **Website:** [lawyers.com/](https://lawyers.com/) | **Docs:** [parse.bot/marketplace/dfae7fea-32ef-4c55-9245-58bc33601134/lawyers-com-api](https://parse.bot/marketplace/dfae7fea-32ef-4c55-9245-58bc33601134/lawyers-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/lawyers/`
**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 detailed profile for an individual attorney. Returns sections with experience, education, services, biography, and contact information. Sections are dynamically structured based on what the attorney has configured on their profile.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the attorney profile page on lawyers.com (e.g. 'https://www.lawyers.com/clifton/new-jersey/franklin-s-montero-168704398-a/') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/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

Get client reviews for a specific attorney or law firm. Fetches reviews from the Martindale-Avvo Legal Network via the profile page. Returns up to 10 reviews per call sorted by date descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the attorney or firm profile page on lawyers.com |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/get-attorney-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get featured firms by topic

Get featured law firms for a specific legal topic. Location is determined from the request IP. Returns up to 3 featured firms with ratings and contact info for the detected geographic area.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `topic` | string | No | Topic slug (e.g. 'family-law', 'dui-dwi', 'bankruptcy', 'criminal-law') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/get-featured-firms-by-topic \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"topic":"<string>"}'
```

### Get law firm profile

Retrieve detailed profile for a law firm including attorneys, practice areas, and contact information. Firm profile URLs end with '-f/' to distinguish from individual attorney profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the law firm profile page on lawyers.com (e.g. 'https://www.lawyers.com/lehi/utah/smith-lc-300023943-f/') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/get-law-firm-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get legal articles

Browse legal information articles by topic. Returns articles and categorized article lists for the given topic slug. Each category groups related articles under a heading.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `topic` | string | No | Topic slug (e.g. 'family-law', 'bankruptcy', 'criminal-law', 'real-estate') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/get-legal-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"topic":"<string>"}'
```

### Get practice areas

List top legal practice areas with their slugs, domains, and IDs. Returns a ranked list of trending practice areas on the platform.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/get-practice-areas \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get top contributors

Get the list of top attorney contributors to the Ask-a-Lawyer Q&A section. Returns attorneys ranked by number of answers provided.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/get-top-contributors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search lawyers

Search for lawyers and law firms by practice area and location. Returns up to 30 results per page. Results include basic profile info (name, rating, phone, website). Sort by relevance, distance, or name. Pagination via page number; empty results signal end of pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | City/state to search in (e.g. 'New York', 'Los Angeles, CA') |
| `page` | integer | No | Page number for pagination |
| `practice_area` | string | No | Legal practice area to search for (e.g. 'Family Law', 'Criminal Defense', 'Immigration') |
| `sort` | string | No | Sort order for results |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/lawyers/search-lawyers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","practice_area":"<string>","sort":"<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.