v1Ressources/Reviews/getLister les validations de réponses
Lister les validations de réponses
Liste les demandes de validation de réponses. Une validation de réponse est un brouillon de réponse à un avis que votre agence envoie à un ou plusieurs utilisateurs du portail client pour qu’ils l’approuvent avant sa mise en ligne. Quand un utilisateur client l’approuve, Synup publie exactement le texte approuvé, y compris sa propre modification ; il peut aussi la programmer pour plus tard ou demander des modifications. La réponse contient la demande la plus récente de chaque avis, de la plus récente à la plus ancienne, parmi 200 demandes au maximum, ainsi que le nombre de demandes en attente du client et de demandes renvoyées avec des modifications. Un jeton limité à certains clients ne voit que ses propres clients.
get
reviews:read/api/v1/reviews/reply-approvalsParamètres de requête
clientIdstringfacultatif
Ne renvoyer que les demandes de ce client.
statusstring (pending | changes_requested | approved | scheduled | posted | failed | withdrawn | cancelled)facultatif
Ne renvoyer que les demandes ayant ce statut.
reviewIdsstringfacultatif
Identifiants d’avis séparés par des virgules, 200 au maximum. Ne renvoyer que les demandes de ces avis.
Réponse
dataobjectfacultatif
countsobjectfacultatif
Totaux sur les clients du jeton, ou pour clientId si vous le transmettez. status et reviewIds ne les restreignent pas.
awaitingintegerfacultatif
Demandes en attente du client (pending).
changesRequestedintegerfacultatif
Demandes renvoyées par le client avec une demande de modifications (changes_requested).
requestsarray of objectfacultatif
La demande la plus récente de chaque avis correspondant, de la plus récente à la plus ancienne.
reviewIdstringfacultatif
L’avis concerné par cette demande.
idstringfacultatif
L’identifiant de la demande. Utilisez-le pour lire l’historique, envoyer une relance ou retirer la demande.
statusstring (pending | changes_requested | approved | scheduled | posted | failed | withdrawn | cancelled)facultatif
Où en est la demande : pending (en attente du client), changes_requested (le client a demandé des modifications ; toujours ouverte, il peut donc encore l’approuver ou vous pouvez envoyer une réponse révisée), approved (approuvée, en cours de publication), scheduled (approuvée pour publication à scheduledFor), posted (la réponse est en ligne), failed (la publication a échoué, voir error), withdrawn (votre agence l’a retirée) ou cancelled (l’avis a reçu une réponse par un autre moyen ou a été supprimé).
versionHashstringfacultatif
Une empreinte du texte. Elle change à chaque modification du texte, et la décision d’un client ne vaut que pour la version qu’il a vue.
textstringfacultatif
La réponse de la demande. Si un client l’a modifiée puis a décidé, c’est sa version.
notestringfacultatif
Votre message pour les utilisateurs clients, ou null.
requestedAtstringfacultatif
Date de création de la demande.
scheduledForstringfacultatif
Date de publication d’une réponse programmée, ou null.
errorstringfacultatif
La raison de l’échec de la publication, ou null.
assigneesarray of objectfacultatif
Les utilisateurs du portail client à qui la demande a été envoyée.
idstringfacultatif
L’identifiant de l’utilisateur client.
namestringfacultatif
Son nom, ou son adresse e-mail si aucun nom n’est renseigné.
emailstringfacultatif
Son adresse e-mail.
decidedBystringfacultatif
Le nom de l’utilisateur client qui a décidé, ou null.
seenobjectfacultatif
Si quelqu’un a ouvert la demande, et où.
emailbooleanfacultatif
true dès que quelqu’un l’a ouverte depuis l’e-mail.
portalbooleanfacultatif
true dès que quelqu’un l’a consultée dans le portail.
lastCommentobjectfacultatif
Le dernier commentaire d’un utilisateur client, ou null.
bodystringfacultatif
Le texte du commentaire.
bystringfacultatif
Le nom de l’utilisateur client qui l’a écrit.
atstringfacultatif
Date de rédaction du commentaire.
emailSkippedstringfacultatif
Pourquoi le dernier e-mail de notification n’a pas été envoyé, sous forme de code court (par exemple switched_off si la personne a désactivé ces e-mails, ou portal_domain_required si l’agence n’a pas de domaine de portail). null si l’e-mail a été envoyé ou n’a pas encore été tenté. Dans tous les cas, la demande reste en attente dans le portail.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/reviews/reply-approvals
Votre clé API
clientId
status
reviewIds
{}Guides qui utilisent cette ressource
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build an AI Agent for Local SEOBuild an AI agent that audits and fixes listings, tracks local rankings, checks AI visibility and drafts review replies with Synup's MCP server or REST tools.
- How to Build an AI Agent That Responds to ReviewsBuild an AI agent that drafts and posts review replies, with rating-based guardrails, human approval for negatives, and protection against injection.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.
- How to Fetch and Respond to Reviews via APIFetch reviews from Google, Facebook and custom review sites, filter them, post owner replies, add internal notes and read review analytics with the Synup API.
- How to Build Automated Review-Response WorkflowsBuild a review-response workflow that routes reviews by rating and sentiment, drafts replies, approves them, and pushes them back to the platform.
- Fetch Recent Reviews via APIPull a location's reviews from every connected platform with the Synup API, filter to what needs attention, and page through with a cursor.
- Local SEO APIs: What Developers Actually NeedA practical checklist of what a local SEO API must cover, from listings and sync status to reviews, rank tracking and AI visibility, mapped to endpoints.
- How to Retrieve Google Business Profile Analytics via APIPull Google Business Profile analytics through an API, portfolio-wide and per location, with views, calls, direction requests and a maps-versus-search split.
- Respond to a Review via APIPost an owner reply to a review with the Synup API, read the push status back, and know which failures are worth a retry.