# Shoreexcursionsgroup — 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 shore excursions from ports worldwide, comparing pricing, features, highlights, and customer reviews all in one place. Find the perfect activity for your cruise stop by filtering destinations and ports, then dive into detailed excursion information to plan your next adventure.

**Category:** Travel | **Website:** [www.shoreexcursionsgroup.com/](https://www.shoreexcursionsgroup.com/) | **Docs:** [parse.bot/marketplace/f5f9b4fd-01f6-4ed3-957a-f75609dba16e/shoreexcursionsgroup-com-api](https://parse.bot/marketplace/f5f9b4fd-01f6-4ed3-957a-f75609dba16e/shoreexcursionsgroup-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-shoreexcursionsgroup-com-api-f5f9b4fd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_excursion_details

Get full details for a specific shore excursion including highlights, features, dress code, restrictions, and review score. The tour_url comes from list_port_excursions results. Returns a single excursion object with all available metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tour_url` | string | Yes | Full URL of the tour from list_port_excursions results (e.g., 'https://www.shoreexcursionsgroup.com/tour/exclusive-juneau-whale-watching/akjnwhlwchcrz') |

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

### get_port_excursions_full

Get full details for excursions at a port by fetching each detail page individually. Slower but returns complete data including highlights, dress code, restrictions, and review scores for each excursion. Use max_excursions to control how many detail pages are fetched.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_excursions` | integer | No | Maximum number of excursions to fetch full details for. |
| `port_slug` | string | Yes | Port URL slug from list_region_ports results (e.g., 'juneau-excursion-tours') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shoreexcursionsgroup-com-api-f5f9b4fd/get_port_excursions_full \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_excursions":"<integer>","port_slug":"<string>"}'
```

### list_destinations

List all available destination regions (e.g., Alaska, Caribbean, Europe). Each destination includes a name and URL; the URL's trailing slug is the region_slug for list_region_ports. Returns all regions in one response with no pagination.

**Estimated cost:** Metered

_No parameters required._

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

### list_port_excursions

List all excursions available at a port with basic pricing info. Returns excursion names, URLs, prices, and optional sale prices. The port_slug comes from list_region_ports results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `port_slug` | string | Yes | Port URL slug from list_region_ports results (e.g., 'juneau-excursion-tours', 'ketchikan-tours') |

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

### list_region_ports

List all ports within a destination region. Returns port names, URLs, and port_slug values for use with list_port_excursions. The region_slug is the trailing path segment from a destination URL (e.g., 'alaska-shore-excursions'). Also accepts the full destination URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region_slug` | string | Yes | Region URL slug extracted from the destination URL path (e.g., 'alaska-shore-excursions', 'caribbean-shore-excursions', 'europe-shore-excursions'). Also accepts the full destination URL. |

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