# Sunbelt Network — 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 browse business-for-sale listings across the Sunbelt Network. Filter by industry, location, price range, cash flow, and more. Retrieve detailed financial summaries, business descriptions, and broker contact information for any listing, and look up Sunbelt office locations nationwide.

**Category:** Marketplaces | **Website:** [sunbeltnetwork.com/](https://sunbeltnetwork.com/) | **Docs:** [parse.bot/marketplace/bc4fbc27-9884-47a3-8e7a-93201406dca3/sunbeltnetwork-com-api](https://parse.bot/marketplace/bc4fbc27-9884-47a3-8e7a-93201406dca3/sunbeltnetwork-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-sunbeltnetwork-com-api-bc4fbc27/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_categories

Retrieve all available industry categories and their numeric IDs. These IDs can be used in the industry parameter of search_listings. The list is fixed at 19 categories.

**Estimated cost:** Metered

_No parameters required._

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

### get_construction_listings

Fetch listings in the Building & Construction industry. Convenience wrapper around search_listings with industry pre-set to 'Building & Construction'. Returns up to 100 results.

**Estimated cost:** Metered

_No parameters required._

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

### get_healthcare_listings

Fetch listings in the Health Care & Fitness industry. Convenience wrapper around search_listings with industry pre-set to 'Health Care & Fitness'. Returns up to 100 results.

**Estimated cost:** Metered

_No parameters required._

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

### get_listing_details

Retrieve comprehensive details for a single business listing given its full URL. Returns financial summary, business information, section descriptions, and broker contact info. The URL is typically obtained from search_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the business listing detail page (e.g. from search_listings results[*].url). |

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

### get_locations

Retrieve all Sunbelt office locations in the network. Returns office name, US state, and page URL for each office. The URL can be passed to get_office_details for address and phone.

**Estimated cost:** Metered

_No parameters required._

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

### get_office_details

Retrieve the street address and phone number for a specific Sunbelt office given its URL (from get_locations results).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the office location page (from get_locations results[*].url). |

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

### search_listings

Full-text search over business-for-sale listings with financial and geographic filters. Paginates server-side; returns up to `limit` results starting from `page`. Each result carries a title, asking price, location, gross revenue, and cash flow. Results whose URL is present can be passed to get_listing_details for the full record.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cf_max` | number | No | Maximum cash flow. |
| `cf_min` | number | No | Minimum cash flow. |
| `country` | string | No | Country name to filter by. |
| `gr_max` | number | No | Maximum gross revenue. |
| `gr_min` | number | No | Minimum gross revenue. |
| `industry` | string | No | Industry name or numeric ID (1-19). Use get_all_categories to retrieve the full list. |
| `limit` | integer | No | Maximum number of listings to return. |
| `page` | integer | No | Starting page number. |
| `price_max` | number | No | Maximum asking price. |
| `price_min` | number | No | Minimum asking price. |
| `query` | string | No | Keyword, city, or listing ID to search for. |
| `relocatable` | boolean | No | When true, filters to relocatable businesses only. |
| `state` | string | No | US state name to filter by (e.g. 'Florida', 'California'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sunbeltnetwork-com-api-bc4fbc27/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cf_max":"<number>","cf_min":"<number>","country":"<string>","gr_max":"<number>","gr_min":"<number>","industry":"<string>","limit":"<integer>","page":"<integer>","price_max":"<number>","price_min":"<number>","query":"<string>","relocatable":"<boolean>","state":"<string>"}'
```