# Lawyers — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/get_attorney_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/get_attorney_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/get_featured_firms_by_topic \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/get_law_firm_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/get_legal_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/get_practice_areas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/get_top_contributors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-lawyers-com-api-dfae7fea/search_lawyers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","practice_area":"<string>","sort":"<string>"}'
```