Collect a location's Google reviews

Embed

<a href="https://seolyticize.com/docs/ref-sync-local-reviews"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/e74d8183-5540-4807-b33b-f539a1fe5c10/social-card.svg?v=3e7ae33eec8b" alt="Collect a location's Google reviews" width="600" height="315"></a>

POSThttps://seolyticize.com/api/v1/tools/sync_local_reviews

Collects the location's latest Google reviews (up to 50) from the vendor. Paid: quote it with estimate_cost first. Runs in the background and takes a few minutes; read the analysis with get_local_visibility afterwards. A second request within the hour lands on the collection already running rather than paying twice. With maxCostMicros, it is refused before it starts when its estimate is over the limit. Answers 'pull in our latest reviews'.

Request body application/json

clientIdstringrequired

locationIdstringrequired

maxCostMicrosinteger

Optional spending limit for this call, in micro-USD (1,000,000 = $1). A purchase that would take the call past it is refused before anything is bought. Pass the estimate from estimate_cost, or what the user agreed to spend.

{
  "clientId": "string",
  "locationId": "string",
  "maxCostMicros": 0
}

Code samples

cURL

curl -X POST "https://seolyticize.com/api/v1/tools/sync_local_reviews" \
  -H "Content-Type: application/json" \
  -d '{"clientId":"string","locationId":"string","maxCostMicros":0}'

TypeScript

const res = await fetch('https://seolyticize.com/api/v1/tools/sync_local_reviews', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"clientId":"string","locationId":"string","maxCostMicros":0}),
});
const data = await res.json();

Python

import requests

res = requests.request(
    "POST",
    "https://seolyticize.com/api/v1/tools/sync_local_reviews",
    headers={
    "Content-Type": "application/json",
    },
    json={"clientId": "string", "locationId": "string", "maxCostMicros": 0},
)
data = res.json()

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://seolyticize.com/api/v1/tools/sync_local_reviews", strings.NewReader(`{"clientId":"string","locationId":"string","maxCostMicros":0}`))
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://seolyticize.com/api/v1/tools/sync_local_reviews');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"clientId":"string","locationId":"string","maxCostMicros":0}');
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://seolyticize.com/api/v1/tools/sync_local_reviews')
req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = '{"clientId":"string","locationId":"string","maxCostMicros":0}'
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(req)
end
puts res.body

Java

import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://seolyticize.com/api/v1/tools/sync_local_reviews"))
    .header("Content-Type", "application/json")
    .method("POST", BodyPublishers.ofString("{\"clientId\":\"string\",\"locationId\":\"string\",\"maxCostMicros\":0}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Responses

200 The tool's result, under data.

Example

{
  "data": {}
}

Schema

datarequired

400 The body was not JSON or did not match the tool's input schema.

Example

{
  "error": "string"
}

Schema

errorstringrequired