# LandFlip — 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 for land listings on LandFlip and retrieve comprehensive property details, including acreage, pricing, and owner financing terms. Filter by state, price range, and acreage to browse available properties.

**Category:** Real Estate | **Website:** [landflip.com/](https://landflip.com/) | **Docs:** [parse.bot/marketplace/e4be5293-08bb-4cc4-9b01-a91242dd854f/landflip-com-api](https://parse.bot/marketplace/e4be5293-08bb-4cc4-9b01-a91242dd854f/landflip-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-landflip-com-api-e4be5293/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_detail

Get detailed information for a specific land listing by its ID. Returns property description, financing terms when available, structured property details (zoning, terrain, taxes, APN), and seller contact info. The listing_id comes from search_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | The LandFlip listing ID (numeric string from search_listings results, e.g. '418775'). |

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

### search_listings

Search for land listings with filters including owner financing, acreage, price, and US state. Returns paginated results with listing summaries. Paginates by page number. Each listing includes an ID usable with get_listing_detail for full property information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `finance` | boolean | No | Filter for owner-financed listings only. |
| `max_acres` | integer | No | Maximum acreage filter. |
| `max_price` | integer | No | Maximum price in USD. |
| `min_acres` | integer | No | Minimum acreage filter. |
| `min_price` | integer | No | Minimum price in USD. |
| `page` | integer | No | Page number for pagination. |
| `state` | string | No | US state name to filter by (e.g. 'Texas', 'Colorado'). Omitting returns listings from all states. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-landflip-com-api-e4be5293/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"finance":"<boolean>","max_acres":"<integer>","max_price":"<integer>","min_acres":"<integer>","min_price":"<integer>","page":"<integer>","state":"<string>"}'
```