Fetch short-term rental market supply, average nightly ADR & Superhost share

Parameters

• marketstringrequired

  City or travel market name (also accepts location or city).

• limitinteger (1 to 50)

  Listings to return (1–50, default 20).

• offsetinteger

  Zero-based pagination offset (default 0).

Example Request (cURL / Python / JavaScript)

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

import requests

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

const res = await fetch("https://api.pindataapi.com/v1/stays/market?market=", {
  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": {
    "market": "Paris",
    "count": 2,
    "market_summary": {
      "average_rating": null,
      "superhost_share_pct": 0
    },
    "listings": [
      {
        "stay_id": "643293547304025326",
        "name": "Paris Curated Stay #643293547304025326",
        "property_type": "Boutique Apartment",
        "room_type": null,
        "city": "Paris",
        "neighborhood": null,
        "market": "Paris",
        "country_code": null,
        "lat": null,
        "lng": null,
        "nightly_rate_usd": null,
        "total_price_usd": null,
        "currency": "USD",
        "rating": null,
        "reviews_count": 0,
        "is_superhost": false,
        "rare_find": false,
        "max_guests": null,
        "bedrooms": null,
        "beds": null,
        "bathrooms": null,
        "min_nights": null,
        "cancel_policy": null,
        "images": [],
        "dominant_color": "#2A9D8F",
        "palette_hex": [
          "#2A9D8F",
          "#E9C46A",
          "#264653",
          "#F4A261"
        ],
        "amenities": [],
        "listing_url": "https://www.airbnb.com/rooms/643293547304025326",
        "last_updated": "2026-11-01 07:57:06"
      },
      {
        "stay_id": "54376622",
        "name": "Paris Curated Stay #54376622",
        "property_type": "Boutique Apartment",
        "room_type": null,
        "city": "Paris",
        "neighborhood": null,
        "market": "Paris",
        "country_code": null,
        "lat": null,
        "lng": null,
        "nightly_rate_usd": null,
        "total_price_usd": null,
        "currency": "USD",
        "rating": null,
        "reviews_count": 0,
        "is_superhost": false,
        "rare_find": false,
        "max_guests": null,
        "bedrooms": null,
        "beds": null,
        "bathrooms": null,
        "min_nights": null,
        "cancel_policy": null,
        "images": [],
        "dominant_color": "#E76F51",
        "palette_hex": [
          "#E76F51",
          "#F4A261",
          "#E9ECEF",
          "#4A4E69"
        ],
        "amenities": [],
        "listing_url": "https://www.airbnb.com/rooms/54376622",
        "last_updated": "2026-10-29 02:46:38"
      }
    ]
  },
  "meta": {
    "request_id": "b4465cd2-d9ab-4807-91e8-24b629615db9",
    "endpoint": "/v1/stays/market",
    "credits_charged": 6,
    "cached": true,
    "took_ms": 1
  }
}

Response Fields

Status Codes

200

Market-level rental summary & listings.

401