# Nolo — 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.

> Access legal articles, state-specific law guides, dictionary definitions, and DIY legal products from Nolo.com. Search across the full Nolo library, browse trending and recent content, and look up legal topics by keyword or category.

**Category:** Government & Public Data | **Website:** [nolo.com/](https://nolo.com/) | **Docs:** [parse.bot/marketplace/24b94b38-6d72-4f5a-bcfd-4b5602876835/nolo-com-api](https://parse.bot/marketplace/24b94b38-6d72-4f5a-bcfd-4b5602876835/nolo-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-nolo-com-api-24b94b38/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article

Fetch the full content of a Nolo legal article by its URL path. Returns the article title, author (when credited), last-updated date (when displayed), structured sections with headings, and concatenated full text. Obtain the url_path from search_articles, get_recent, get_trending, or renters' rights listing endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | Article URL path starting with / (e.g. '/landlord-tenant/how-to-delay-an-eviction.html'). Obtain from search_articles, get_recent, get_trending, or other listing endpoints. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_path":"<string>"}'
```

### get_books_by_topic

Search for DIY legal books and tools by topic in the Nolo store. Returns products with titles, authors, edition info, format-specific prices, and descriptions. Results come from store.nolo.com.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `topic` | string | Yes | Topic to search for (e.g. 'eviction', 'divorce', 'bankruptcy'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_books_by_topic \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic":"<string>"}'
```

### get_legal_dictionary_term

Fetch a legal term definition from the Nolo legal dictionary. Returns the canonical term heading and its full plain-text definition. The term is looked up by slug derived from the input; returns input_not_found if the term page does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `term` | string | Yes | Legal term to look up (e.g. 'habeas corpus', 'lease', 'eviction'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_legal_dictionary_term \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"term":"<string>"}'
```

### get_recent

Fetch recently modified articles from Nolo.com. Returns a flat list of articles ordered by most recently updated. Each article carries a title and full URL. No parameters; the server decides recency window and count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_recent \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_renters_rights_overview

Fetch the top-level Renters' Rights hub from Nolo.com. Returns named sub-topic categories (e.g. Security Deposits, Evictions) with URLs, plus a Key Articles list linking to the most important tenant-focused pages.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_renters_rights_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_state_renters_rights

Fetch renters' rights information for a specific U.S. state. Returns categories of tenant-related topics (Evictions, Security Deposits, etc.) each with links to relevant articles. The state must match a name from get_state_renters_rights_index.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | Yes | U.S. state name exactly as listed in get_state_renters_rights_index (e.g. 'California', 'New York', 'Texas', 'D.C.'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_state_renters_rights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### get_state_renters_rights_index

Fetch the index of all U.S. states (and D.C.) with links to their state-specific renters' rights pages on Nolo.com. Returns 51 entries (50 states + D.C.).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_state_renters_rights_index \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_trending

Fetch trending articles from Nolo.com. Returns a flat list of currently popular articles with titles and URLs. No parameters; the server curates the trending set.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/get_trending \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_all

Global search across all Nolo network content including articles, products, and dictionary terms. Returns results from multiple Nolo network sites (nolo.com, lawyers.com, etc.) with source attribution.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase. |

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

### search_articles

Search Nolo articles by keyword. Returns paginated results with article titles, URLs, and text snippets. Results come from the www.nolo.com subdomain. Pagination advances by integer page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nolo-com-api-24b94b38/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```