Vrbo Reviews

List Vrbo reviews, reply to what a guest wrote, and rate the guest after the stay — the counterpart of Airbnb reviews. Reading and replying also work from the unified Reviews API with the same review id.

PUT/v1/channels/vrbo/reviews/:id

Parameters

idstringRequired

The review id from GET /v1/channels/vrbo/reviews?reviewerRole=host.

ratingintegerRequired

The overall experience, 1–5.

categoryRatingsarray

[{ "category": "cleanliness", "rating": 5 }] — cleanliness, communication, respect_house_rules. No comments.

isRevieweeRecommendedboolean

Whether you would rent to the guest again.

List reviews

GET /v1/channels/vrbo/reviews lists the workspace's Vrbo reviews — the same list, filters, paging and review shape as GET /v1/reviews?platform=vrbo. reviewerRole=guest (default) is what guests wrote about the stay; reviewerRole=host the stays you can rate. Filter with listingId, status (responded, unanswered).

Reply to a guest's review

POST /v1/reviews/{id}/reply with { "message": "…" } publishes your response under the review — the same call as on Airbnb. Vrbo signs it with a name: the host name on the account, or the name you send. Vrbo takes one response per review (409 already_replied after that).

Rate the guest

PUT /v1/channels/vrbo/reviews/{id} rates the guest of a stay — Vrbo's "Rate guest", the counterpart of PUT /v1/channels/airbnb/reviews/{id}, and the same as POST /v1/reviews/{id}/guest-review.

  • Differs from Airbnb: Vrbo's rating is stars and "would you host them again", with no written review and nothing shown to the guest. publicReview and privateFeedback are refused by name when they are not empty.
  • A review from another channel is 404 on this route. A guest already rated answers 409 review_already_submitted; a stay Vrbo no longer takes a rating for, 409 review_window_closed.

Example

# Vrbo reviews still waiting for a response
curl 'https://api.repull.dev/v1/channels/vrbo/reviews?status=unanswered' \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# Reply
curl -X POST https://api.repull.dev/v1/reviews/181567/reply \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Thank you, Katherine — come back soon!"}'

# Rate the guest
curl -X PUT https://api.repull.dev/v1/channels/vrbo/reviews/181568 \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rating": 5, "categoryRatings": [{"category": "cleanliness", "rating": 5}], "isRevieweeRecommended": true}'

Response

{
  "id": "181568",
  "submitted": true,
  "platform": "vrbo",
  "rating": { "overallExperience": 5, "cleanliness": 5, "rentAgain": true }
}
AI