Google Reviews API

const dataId = "0x89c259af98ec7cbd:0x654b31dc1f9816db";

// First request
const response = await fetch(
  `https://api.stayapi.com/v1/google_reviews/reviews?` +
  new URLSearchParams({
    data_id: dataId,
    sort_by: "newest"
  }),
  {
    headers: { "X-API-Key": "YOUR_API_KEY" }
  }
);

const data = await response.json();
console.log(`Place: ${data.place_name}`);
console.log(`Total reviews: ${data.total_reviews}`);
console.log(`Reviews on this page: ${data.reviews.length}`);

// If there are more reviews, use next_page_token
if (data.has_more && data.next_page_token) {
  const nextResponse = await fetch(
    `https://api.stayapi.com/v1/google_reviews/reviews?` +
    new URLSearchParams({
      data_id: dataId,
      next_page_token: data.next_page_token
    }),
    {
      headers: { "X-API-Key": "YOUR_API_KEY" }
    }
  );
  // ... continue pagination
}

import requests

data_id = "0x89c259af98ec7cbd:0x654b31dc1f9816db"

# First request
response = requests.get(
    "https://api.stayapi.com/v1/google_reviews/reviews",
    params={
        "data_id": data_id,
        "sort_by": "newest"
    },
    headers={"X-API-Key": "YOUR_API_KEY"}
)

data = response.json()
print(f"Place: {data['place_name']}")
print(f"Total reviews: {data['total_reviews']}")
print(f"Reviews on this page: {len(data['reviews'])}")

# Fetch all reviews with pagination
all_reviews = data['reviews']
next_token = data.get('next_page_token')

while data.get('has_more') and next_token:
    response = requests.get(
        "https://api.stayapi.com/v1/google_reviews/reviews",
        params={
            "data_id": data_id,
            "next_page_token": next_token
        },
        headers={"X-API-Key": "YOUR_API_KEY"}
    )
    data = response.json()
    all_reviews.extend(data['reviews'])
    next_token = data.get('next_page_token')

print(f"Total fetched: {len(all_reviews)} reviews")

$dataId = "0x89c259af98ec7cbd:0x654b31dc1f9816db";

// First request
$params = [
    "data_id" => $dataId,
    "sort_by" => "newest"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.stayapi.com/v1/google_reviews/reviews?" . http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);

echo "Place: " . $data["place_name"] . "\n";
echo "Total reviews: " . $data["total_reviews"] . "\n";
echo "Reviews on this page: " . count($data["reviews"]) . "\n";

// Continue with pagination using next_page_token
if ($data["has_more"] && !empty($data["next_page_token"])) {
    $params["next_page_token"] = $data["next_page_token"];
    unset($params["sort_by"]);  // Only needed for first request
    // ... make next request
}

{
  "type": "https://api.stayapi.com/errors/invalid-parameters",
  "title": "Invalid Parameters",
  "status": 400,
  "detail": "data_id is required",
  "instance": "/v1/google_reviews/reviews",
  "provider": "google_reviews",
  "error_code": "INVALID_PARAMETERS",
  "correlation_id": "req_abc123"
}