Stayingapi portfolio feed

Portfolio price & occupancy feed

Owners and property managers watch a fixed set of listings — their own units, or the ones a client cares about — and want one daily readout instead of opening each app. This feed takes your saved "platform:listingId" set, and for each listing pulls full detail (GET /v1/listing/{platform}/{id}), a real nightly price for your dates (GET /v1/price) and the latest reviews (GET /v1/reviews), then consolidates everything into a single report you can drop into Slack, email, a Google Sheet or a BI tool — the same shape across Airbnb, Booking.com and Vrbo.

• Base URL: https://api.stayingapi.com/v1 (REST) · MCP: https://mcp.stayingapi.com/mcp
• Auth: Authorization: Bearer stay_live_… (free sandbox: stay_test_…).
• Get a free key (no card): https://stayingapi.com/signup · Full machine contract: https://api.stayingapi.com/openapi.json

Steps

1. List the portfolio and the dates — Set your saved listings as "platform:listingId" pairs plus the check-in / check-out to price against. A Code node fans the set out into one item per listing.
2. Pull detail, price and reviews per listing — For each listing the pipeline calls GET /v1/listing/{platform}/{id} (name, rating, amenities), GET /v1/price (a real nightly + total for your dates) and GET /v1/reviews (the latest few).
3. Consolidate into one digest — A Code node correlates the three responses per listing, computes the portfolio median nightly, and formats one report — price, rating and recent-review count per listing.
4. Deliver daily — Post the digest to Slack or email, or append rows to a Google Sheet / BI feed for tracking over time. Runs on a daily schedule.

When to use this

A host, owner or property manager wants one daily readout across a fixed set of listings — their own units or a client's — instead of opening each platform's app.

How to do it

For each saved platform:listingId in the set, make three calls and join them:

1. GET /v1/listing/{platform}/{id} (pass checkIn/checkOut to embed a best-effort price) → name, guestRating, ratingScale, amenities.
2. GET /v1/price?platform=&listingId=&checkIn=&checkOut= → a real nightlyPrice + totalPrice for the exact dates.
3. GET /v1/reviews?platform=&listingId=&limit=5&sort=recent → the latest guest reviews.

Roll one row per listing (price, rating, recent-review count) plus a portfolio median into a single digest. Use @stayingapi/sdk (scout.listing, scout.price, scout.reviews) or the REST endpoints directly.

Reliability

Live calls run asynchronously — the SDK auto-polls; raw REST callers poll GET /v1/jobs/{id}. A blocked or empty call is charged 0 and simply shows as "price n/a" for that listing, so one bad platform never sinks the whole digest. Current per-call credit costs are on the pricing page.

Example — REST

# For each saved listing: detail, a real price for your dates, and recent reviews.
curl -sS "https://api.stayingapi.com/v1/listing/airbnb/42307961?checkIn=2026-07-13&checkOut=2026-07-20" \
  -H "Authorization: Bearer $STAYINGAPI_KEY"
curl -sS "https://api.stayingapi.com/v1/price?platform=airbnb&listingId=42307961&checkIn=2026-07-13&checkOut=2026-07-20" \
  -H "Authorization: Bearer $STAYINGAPI_KEY"
curl -sS "https://api.stayingapi.com/v1/reviews?platform=airbnb&listingId=42307961&limit=5&sort=recent" \
  -H "Authorization: Bearer $STAYINGAPI_KEY"

Example — @stayingapi/sdk

import { StayingApiClient } from '@stayingapi/sdk';

const scout = new StayingApiClient({ apiKey: process.env.STAYINGAPI_KEY });

const portfolio = [
  { platform: 'airbnb', listingId: '42307961' },
  { platform: 'booking', listingId: 'abramovic2' },
];
const dates = { checkIn: '2026-07-13', checkOut: '2026-07-20' };

const digest = [];
for (const { platform, listingId } of portfolio) {
  const [{ data: listing }, { data: price }, { data: reviews }] = await Promise.all([
    scout.listing(platform, listingId, dates),
    scout.price({ platform, listingId, ...dates }),
    scout.reviews({ platform, listingId, limit: 5, sort: 'recent' }),
  ]);
  digest.push({
    name: listing.name,
    nightly: price?.nightlyPrice ?? null,
    rating: listing.guestRating,
    recentReviews: reviews.length,
  });
}
console.table(digest);

Async & partial failures

A live call that has to scrape returns 202 + a jobId; poll GET /v1/jobs/{jobId} (free) until data.status is completed, then read data.result. The @stayingapi/sdk auto-polls. On a fan-out, check meta.partial and meta.platformResults[] — report what succeeded and note any meta.warnings[].

Credit awareness

Costs are per-endpoint and metered by result (v3). Failed, empty and blocked calls are never billed, and sandbox (stay_test_) calls are always free. The exact, current costs live only in https://stayingapi.com/pricing and the machine-readable https://api.stayingapi.com/openapi.json — read them there, don't assume.

---

Get your free key → https://stayingapi.com/signup · Docs: https://stayingapi.com/docs · Workflow: https://stayingapi.com/workflows/portfolio-feed