# Snapptrip — 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 book hotels, villas, and apartments across Iran's largest travel platform by accessing real-time listings, detailed property information, and availability. Find your perfect accommodation with comprehensive search capabilities and in-depth details on thousands of properties available through Snapptrip.

**Category:** Travel | **Website:** [www.snapptrip.com/](https://www.snapptrip.com/) | **Docs:** [parse.bot/marketplace/dd89127b-6cf1-4460-b144-87b4dcf048b4/snapptrip-com-api](https://parse.bot/marketplace/dd89127b-6cf1-4460-b144-87b4dcf048b4/snapptrip-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-snapptrip-com-api-dd89127b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_hotel_detail

Get detailed information for a specific hotel including room types with prices, and user reviews. Requires check_in/check_out dates to retrieve room availability and pricing. The hotel_id is obtained from search_hotels results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `check_in` | string | Yes | Check-in date in ISO format YYYY-MM-DD. |
| `check_out` | string | Yes | Check-out date in ISO format YYYY-MM-DD. Must be after check_in. |
| `hotel_id` | string | Yes | Numeric hotel ID from search_hotels results (e.g. '60'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-snapptrip-com-api-dd89127b/get_hotel_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"check_in":"<string>","check_out":"<string>","hotel_id":"<string>"}'
```

### search_hotels

Search for available hotels in a given city for specified dates. Returns paginated results ordered by best-selling, including hotel name, star rating, user score, price, address, amenities, and location. Each page returns up to 20 hotels. The hotel_id in results can be used with get_hotel_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `check_in` | string | Yes | Check-in date in ISO format YYYY-MM-DD. |
| `check_out` | string | Yes | Check-out date in ISO format YYYY-MM-DD. Must be after check_in. |
| `city` | string | Yes | City name in Persian or English (e.g. 'tehran', 'مشهد', 'isfahan'). Resolved to a city_id internally. |
| `guests` | string | No | Number of rooms/guests (used as no_rooms parameter). |
| `page` | integer | No | Page number for pagination, starting from 1. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-snapptrip-com-api-dd89127b/search_hotels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"check_in":"<string>","check_out":"<string>","city":"<string>","guests":"<string>","page":"<integer>"}'
```

### search_villas

Search for available villas, apartments, and short-term rental accommodations in a given city. Returns paginated results with pricing, capacity, location, rating, and amenities. Results include various property types (VILLA, APARTMENT, HOTEL_APARTMENT, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `check_in` | string | Yes | Check-in date in ISO format YYYY-MM-DD. |
| `check_out` | string | Yes | Check-out date in ISO format YYYY-MM-DD. Must be after check_in. |
| `city` | string | Yes | City name or slug in Persian or English (e.g. 'ramsar', 'تهران'). Resolved to a city slug internally. |
| `guests` | string | No | Number of guests (capacity filter). |
| `page` | integer | No | Page number for pagination, starting from 1. Each page returns up to 20 results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-snapptrip-com-api-dd89127b/search_villas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"check_in":"<string>","check_out":"<string>","city":"<string>","guests":"<string>","page":"<integer>"}'
```