Search boutique short-term stays with nightly USD rates, Superhost badges & HD photos

Parameters

• locationstringrequired

  Destination city, neighborhood, or region (also accepts query or city).

• checkinstring

  Check-in date YYYY-MM-DD (defaults to +30 days if omitted).

• checkoutstring

  Check-out date YYYY-MM-DD (defaults to +33 days if omitted).

• adultsinteger (1 to 16)

  Number of adult guests (1–16, default 2).

• currencystring

  ISO-4217 currency code (default USD).

• limitinteger (1 to 40)

  Maximum listings to return (1–40, default 20).

Example Request (cURL / Python / JavaScript)

curl "https://api.pindataapi.com/v1/stays/search?location=" \
  -H "x-api-key: pn_live_your_api_key"

import requests

res = requests.get(
    "https://api.pindataapi.com/v1/stays/search?location=",
    headers={"x-api-key": "pn_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.pindataapi.com/v1/stays/search?location=", {
  headers: { "x-api-key": "pn_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://pindataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "location": "Paris",
    "checkin": "2026-12-14",
    "checkout": "2026-12-17",
    "adults": 2,
    "currency": "USD",
    "count": 2,
    "stays": [
      {
        "stay_id": "41507144",
        "name": "Cosy studio near Eiffel Tower",
        "property_type": "Apartment",
        "room_type": "Entire home/apt",
        "city": "Paris",
        "neighborhood": null,
        "market": "Paris",
        "country_code": null,
        "lat": 48.8473,
        "lng": 2.2951,
        "nightly_rate_usd": 510,
        "total_price_usd": 509.44,
        "currency": "USD",
        "rating": 4.84,
        "reviews_count": 473,
        "is_superhost": false,
        "rare_find": true,
        "max_guests": null,
        "bedrooms": 0,
        "beds": 1,
        "bathrooms": 1,
        "min_nights": null,
        "cancel_policy": null,
        "images": [
          "https://a0.muscache.com/im/pictures/ddae76b6-26ec-4652-be2d-9f6b97aa536d.jpg",
          "https://a0.muscache.com/im/pictures/c7c73a1e-a0e7-4621-bb85-3bcf7bb2f047.jpg",
          "https://a0.muscache.com/im/pictures/7f4ede03-1b6e-4a45-a189-36825d82fc25.jpg",
          "https://a0.muscache.com/im/pictures/135d9109-37d8-4f59-b47e-eece7ec95ee8.jpg",
          "https://a0.muscache.com/im/pictures/b27f47cf-8fdf-4140-8d4e-9887fa97211f.jpg",
          "https://a0.muscache.com/im/pictures/9b174ce3-4c61-4797-82d5-c652b80ad571.jpg"
        ],
        "dominant_color": "#6B705C",
        "palette_hex": [
          "#6B705C",
          "#CB997E",
          "#FFE8D6",
          "#A5A58D"
        ],
        "amenities": [],
        "listing_url": "https://www.airbnb.com/rooms/41507144",
        "last_updated": "2026-11-14T17:23:40.607Z"
      },
      {
        "stay_id": "1333842490138337108",
        "name": "Bed and breakfast near the Jardin des Plantes",
        "property_type": "Room",
        "room_type": "Entire home/apt",
        "city": "Paris",
        "neighborhood": null,
        "market": "Paris",
        "country_code": null,
        "lat": 48.8442,
        "lng": 2.3537,
        "nightly_rate_usd": 333,
        "total_price_usd": 332.63,
        "currency": "USD",
        "rating": 4.8,
        "reviews_count": 30,
        "is_superhost": true,
        "rare_find": false,
        "max_guests": null,
        "bedrooms": 0,
        "beds": 1,
        "bathrooms": 1,
        "min_nights": null,
        "cancel_policy": null,
        "images": [
          "https://a0.muscache.com/im/pictures/hosting/Hosting-1333842490138337108/original/875df1ce-c36c-41ba-9b7d-b23df58d48dc.jpeg",
          "https://a0.muscache.com/im/pictures/hosting/Hosting-1333842490138337108/original/107a5019-076c-4d77-8363-e3640c9d14f2.jpeg",
          "https://a0.muscache.com/im/pictures/hosting/Hosting-1333842490138337108/original/009be4a6-a366-47de-bcfd-5815e890b3ee.jpeg",
          "https://a0.muscache.com/im/pictures/hosting/Hosting-1333842490138337108/original/41efae49-5381-4893-a88b-f15755b12804.jpeg",
          "https://a0.muscache.com/im/pictures/hosting/Hosting-1333842490138337108/original/3d1940ca-8ddf-44f2-b76d-47b83df18473.jpeg",
          "https://a0.muscache.com/im/pictures/hosting/Hosting-1333842490138337108/original/9c8fed20-366c-48e8-bdc0-4f2974cc2cae.jpeg"
        ],
        "dominant_color": "#B5838D",
        "palette_hex": [
          "#B5838D",
          "#FFCDB2",
          "#DDBEA9",
          "#6D6875"
        ],
        "amenities": [],
        "listing_url": "https://www.airbnb.com/rooms/1333842490138337108",
        "last_updated": "2026-11-14T17:23:40.607Z"
      }
    ]
  },
  "meta": {
    "request_id": "bf1061f7-3195-4d39-a601-1ebbc6fe12c4",
    "endpoint": "/v1/stays/search",
    "credits_charged": 10,
    "cached": false,
    "took_ms": 1796
  }
}

Response Fields

Status Codes

200

Normalized boutique stay search results.

401