Reviews

{
  "data": [
    {
      "id": 778201,
      "external_id": "abnb_rev_xyz789",
      "platform": "airbnb",
      "listing_id": 4118,
      "reservation_id": 216039,
      "reservation_confirmation_code": "HMABCDE123",
      "guest_id": 88341,
      "guest_name": "Sarah Mitchell",
      "guest_avatar": "https://images.repull.dev/g/88341.jpg",
      "reviewer_role": "guest",
      "rating": 2,
      "categories": [
        { "category": "cleanliness",   "rating": 1, "comment": "Found hair in the bathroom." },
        { "category": "communication", "rating": 5, "comment": null },
        { "category": "accuracy",      "rating": 3, "comment": null },
        { "category": "location",      "rating": 5, "comment": null },
        { "category": "check_in",      "rating": 4, "comment": null },
        { "category": "value",         "rating": 2, "comment": null }
      ],
      "public_review": "Beautiful location but the cleaning was below standard.",
      "private_feedback": "The bathroom needs a deeper clean — found hair in the shower.",
      "is_reviewee_recommended": null,
      "response": null,
      "submitted_at": "2026-04-29T11:14:09.000Z",
      "updated_at": "2026-04-29T11:14:09.000Z",
      "expires_at": "2026-05-13T11:14:09.000Z",
      "hidden": false
    },
    {
      "id": 778202,
      "external_id": "abnb_rev_xyz790",
      "platform": "airbnb",
      "listing_id": 4118,
      "reservation_id": 216039,
      "reservation_confirmation_code": "HMABCDE123",
      "guest_id": 88341,
      "guest_name": "Sarah Mitchell",
      "guest_avatar": "https://images.repull.dev/g/88341.jpg",
      "reviewer_role": "host",
      "rating": null,
      "categories": [],
      "public_review": "Sarah was a respectful guest and left the place tidy.",
      "private_feedback": null,
      "is_reviewee_recommended": true,
      "response": null,
      "submitted_at": "2026-04-29T09:02:11.000Z",
      "updated_at": "2026-04-29T09:02:11.000Z",
      "expires_at": null,
      "hidden": false
    }
  ],
  "pagination": {
    "nextCursor": "eyJsYXN0SWQiOjc3ODIwMn0",
    "hasMore": true
  }
}

{
  "data": {
    "id": 778201,
    "external_id": "abnb_rev_xyz789",
    "platform": "airbnb",
    "listing_id": 4118,
    "reservation_id": 216039,
    "reservation_confirmation_code": "HMABCDE123",
    "guest_id": 88341,
    "guest_name": "Sarah Mitchell",
    "guest_avatar": "https://images.repull.dev/g/88341.jpg",
    "reviewer_role": "guest",
    "rating": 2,
    "categories": [
      { "category": "cleanliness", "rating": 1, "comment": "Found hair in the bathroom." }
    ],
    "public_review": "Beautiful location but the cleaning was below standard.",
    "private_feedback": "The bathroom needs a deeper clean — found hair in the shower.",
    "is_reviewee_recommended": null,
    "response": {
      "body": "Sarah, thank you for the feedback — we've already retrained the cleaning team. Hope you'll give us another chance.",
      "submitted_at": "2026-04-30T08:14:00.000Z"
    },
    "submitted_at": "2026-04-29T11:14:09.000Z",
    "updated_at": "2026-04-30T08:14:00.000Z",
    "expires_at": "2026-05-13T11:14:09.000Z",
    "hidden": false
  }
}

curl -X POST 'https://api.repull.dev/v1/reviews/778201/reply'   -H 'Authorization: Bearer sk_live_...'   -H 'Content-Type: application/json'   -d '{"message": "Thank you for staying with us — come back any time!"}'

curl -X POST 'https://api.repull.dev/v1/reviews/181567/guest-review'   -H 'Authorization: Bearer sk_live_...'   -H 'Content-Type: application/json'   -d '{
    "publicReview": "Joanne was a great guest — the place was left spotless.",
    "rating": 5,
    "categoryRatings": [
      { "category": "communication", "rating": 4, "comment": "A little slow to reply" }
    ],
    "privateFeedback": "Thanks for taking such good care of the place!",
    "isRevieweeRecommended": true
  }'

import type { Review } from '@repull/sdk'

const queue: Review[] = []
let cursor: string | undefined

// reviewerRole defaults to guest — host-side reviews don't get host responses
do {
  const page = await repull.reviews.list({
    status: 'unanswered',
    cursor,
    limit: 100,
  })
  queue.push(...page.data)
  cursor = page.pagination.nextCursor ?? undefined
} while (cursor)

queue.sort((a, b) => (a.expiresAt ?? '').localeCompare(b.expiresAt ?? ''))

for (const r of queue.slice(0, 20)) {
  console.log(r.id, r.platform, '— expires', r.expiresAt, '—', r.publicReview?.slice(0, 60))
}

import type { Review } from '@repull/sdk'

const startOfMonth = new Date()
startOfMonth.setUTCDate(1)
startOfMonth.setUTCHours(0, 0, 0, 0)
const cutoff = startOfMonth.toISOString()

const lowRatings: Review[] = []
let cursor: string | undefined

do {
  const page = await repull.reviews.list({
    rating_max: 3,
    cursor,
    limit: 100,
  })
  for (const r of page.data) {
    if (r.submittedAt && r.submittedAt >= cutoff) lowRatings.push(r)
  }
  cursor = page.pagination.nextCursor ?? undefined
} while (cursor)

console.log(lowRatings.length, 'low-rating reviews this month')

// The listing filter is query-string only (`listingId`), so this pattern
// calls the API directly.
const headers = { Authorization: `Bearer ${process.env.REPULL_API_KEY}` }
const reviews: Array<{ rating: number | null }> = []
let cursor: string | null = null

do {
  const url = new URL('https://api.repull.dev/v1/reviews')
  url.searchParams.set('listingId', '4118')
  url.searchParams.set('limit', '100')
  if (cursor) url.searchParams.set('cursor', cursor)

  const page = await fetch(url, { headers }).then((r) => r.json())
  reviews.push(...page.data)
  cursor = page.pagination.nextCursor
} while (cursor)

const scored = reviews.filter((r) => r.rating != null)
const avg = scored.reduce((a, r) => a + (r.rating as number), 0) / scored.length

console.log('Listing 4118 average:', avg.toFixed(2), 'across', scored.length, 'reviews')