Added Listing Optimizer endpoints 🎉
Three new endpoints to read Listing Optimizer data programmatically:
GET /v1/listing_optimizer/summary
Returns Listing Optimizer scores across your account — overall score, status, and basic info for each Airbnb listing, along with whether the listing can be manually rerun. Use this first to get a portfolio-wide overview.
Supports optional subscribed, status, and listing_ids query parameters to filter the returned listings.
GET /v1/listing_optimizer/report
Returns full details for one listing: overall score, category letter grades, what drove each score, improvement tips, and previous-run grades for comparison.
Parameters: listing_id (required), pms_name (optional, defaults to airbnb).
GET /v1/listing_optimizer/ranking
Returns competitive search-result ranking data for one listing: current rank by guest-count × LOS segment, neighborhood competitor count, and up to 90 days of ranking history.
Parameters: listing_id (required), pms_name, guest_count, los, history_start_date (all optional).
See Listing Optimizer for full request and response details.
Added Nudge endpoints 🎉
Price nudges recommend base price or minimum price adjustments for listings. You can now list available nudges and accept them programmatically via the Customer API.
GET /v1/nudges/available
Returns pending, non-expired nudges for listings accessible to the authenticated user. Results can be filtered by nudge_type (base_price or min_price), listing_id, and pms.
POST /v1/nudges/accept
Accepts a price nudge for a single listing, updating the listing’s base price or minimum price to the nudge-recommended value. Requires write permission on the listing. Use update_children: true to propagate the change to child listings.
See Nudges for full request and response details.