Endpoint reference

Reviews

Normalized, paginated reviews for one listing.

GET/v1/reviews

Normalized, paginated reviews for one listing.

Credits2 credits / 20-review block

Cache TTL24 hours

ReturnsReview[]

ShapePaginated

Normalized, paginated reviews for one listing on one platform. Native rating scales are preserved and echoed alongside each rating (TripAdvisor/Airbnb/Vrbo use 5; Booking.com/Expedia/Hotels.com use 10) — never silently rescaled.

Parameters

Request parameters
Parameter	Type	Required	Default	Notes
`platform`	`enum`	Yes	—	Platform enum.
`listingId`	`string`	One of	—	Listing id on platform.
`url`	`string`	One of	—	Full listing URL.
`limit`	`integer`	No	`20`	1–100 (also the billing block).
`cursor`	`string`	No	—	Opaque base64 cursor.
`language`	`string`	No	—	ISO-639-1 filter.
`minRating`	`number`	No	—	On the response ratingScale.
`sort`	`enum`	No	`recent`	recent \| rating_desc \| rating_asc.

Request & response

/v1/reviews

Request

GET /v1/reviews?platform=booking&listingId=abramovic2&limit=20&sort=recent
Host: api.scoutingapi.com
Authorization: Bearer scout_live_…

Response

{
  "data": [
    {
      "platform": "booking",
      "listingId": "abramovic2",
      "reviewId": "r987",
      "rating": 9, "ratingScale": 10,
      "title": "Perfect family stay",
      "text": "Spotless apartment a short walk from the old town…",
      "author": "Jane D.", "date": "2026-05-10", "tripType": "family",
      "language": "en", "ownerResponse": "Thank you!",
      "liked": "Location and cleanliness", "disliked": null
    }
  ],
  "meta": {
    "requestId": "req_rv…",
    "platforms": ["booking"],
    "cached": false, "partial": false,
    "creditsCharged": 2, "currency": "USD",
    "pagination": { "limit": 20, "cursor": null, "nextCursor": "eyJ…", "hasMore": true },
    "platformResults": [
      { "platform": "booking", "status": "ok", "creditsCharged": 2, "cached": false, "count": 20 }
    ],
    "warnings": []
  }
}

Code samples

The same call in every language that matters — all returning the identical unified schema.

GET /v1/reviews

curl -sS "https://api.scoutingapi.com/v1/reviews?platform=booking&listingId=abramovic2&limit=20&sort=recent" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"

Try it

Run this endpoint against the deterministic sandbox right now — a real 200, zero credits, no sign-up. The credit cost of the equivalent live call is 2 credits / 20-review block.

Try itsandbox · 0 credits · no sign-up

GET/v1/reviews

platformlistingIdlimitsortAPI key (optional)

Runs against the deterministic Booking sandbox fixture — a real 200, zero credits.

Response

Run the call to see a live, deterministic sandbox response.

Copy as curl

curl -sS "https://api.scoutingapi.com/v1/reviews" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"