# Flippa — 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 digital assets like websites, domains, and SaaS businesses listed on Flippa's marketplace, with detailed filtering by country and listing details. Access comprehensive information on thousands of digital business listings to find investment opportunities or monitor the market.

**Category:** Marketplaces | **Website:** [flippa.com/](https://flippa.com/) | **Docs:** [parse.bot/marketplace/380513ea-00fe-4e1d-9e18-8aa95ada11a7/flippa-com-api](https://parse.bot/marketplace/380513ea-00fe-4e1d-9e18-8aa95ada11a7/flippa-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-flippa-com-api-380513ea/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_detail

Retrieve the canonical URL for a specific listing by its numeric ID. The canonical URL includes the full listing slug, useful for constructing direct links. Best used with listing IDs obtained from search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | The numeric listing ID (e.g., '12668272'). Obtainable from search_listings, list_domains_for_sale, list_businesses_for_sale, or list_businesses_by_country results. |

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

### list_businesses_by_country

List non-domain business listings filtered by seller country. Returns all business property types (websites, SaaS, e-commerce, FBA, apps, services, etc.) for the specified country code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | Yes | ISO country code for seller location (e.g., 'us', 'uk', 'ca', 'au'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flippa-com-api-380513ea/list_businesses_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","page":"<integer>"}'
```

### list_businesses_for_sale

List non-domain business listings for sale on Flippa (websites, SaaS, e-commerce, FBA, apps, services, etc.) with price range, profit multiple, and seller location filters. Results are manually filtered to ensure strict match against price and multiple criteria.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `multiple_max` | number | No | Maximum profit multiple. |
| `multiple_min` | number | No | Minimum profit multiple. |
| `page` | integer | No | Page number for pagination. |
| `price_max` | number | No | Maximum asking price in USD. |
| `price_min` | number | No | Minimum asking price in USD. |
| `seller_location` | string | No | Seller country code (e.g., 'us', 'uk', 'ca'). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flippa-com-api-380513ea/list_businesses_for_sale \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"multiple_max":"<number>","multiple_min":"<number>","page":"<integer>","price_max":"<number>","price_min":"<number>","seller_location":"<string>","sort":"<string>"}'
```

### list_domains_for_sale

List domain-name listings currently for sale on Flippa. Equivalent to searching with property_type=domain. Returns paginated results sorted by the chosen order.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flippa-com-api-380513ea/list_domains_for_sale \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sort":"<string>"}'
```

### search_listings

Full-text search across all Flippa marketplace listings with filtering by property type, price range, profit multiple, and seller location. Returns paginated results including sponsored and early-access listings separately. Flippa may include sponsored listings outside filter ranges; the manual_filter option applies strict client-side enforcement of price and multiple criteria.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `manual_filter` | boolean | No | Whether to apply strict client-side filtering to enforce price and multiple criteria. Recommended because Flippa may include sponsored listings outside filter ranges. |
| `multiple_max` | number | No | Maximum profit multiple. |
| `multiple_min` | number | No | Minimum profit multiple. |
| `page` | integer | No | Page number for pagination. |
| `price_max` | number | No | Maximum asking price in USD. |
| `price_min` | number | No | Minimum asking price in USD. |
| `property_type` | string | No | Comma-separated property types to filter by. Accepted values include: website, domain, fba, saas, ecommerce_store, plugin_and_extension, ai_apps_and_tools, youtube, ios_app, android_app, game, crypto_app, social_media, newsletter, service_and_agency, service, projects_and_concepts, other. |
| `query` | string | No | Search keyword to match against listing titles and descriptions. |
| `seller_location` | string | No | Seller country code (e.g., 'us', 'uk', 'ca', 'au'). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flippa-com-api-380513ea/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"manual_filter":"<boolean>","multiple_max":"<number>","multiple_min":"<number>","page":"<integer>","price_max":"<number>","price_min":"<number>","property_type":"<string>","query":"<string>","seller_location":"<string>","sort":"<string>"}'
```