GET/api/v4/reviews/site-config

Listar las fuentes de reseñas de una cuenta

Devuelve las plataformas de reseñas disponibles en tu cuenta: Google Maps y Facebook en todos los planes; Yelp en Growth y Enterprise.

Requiere una clave de API. Consulta Autenticación para conocer el formato del encabezado y la rotación de claves.

Parámetros

Este endpoint no recibe parámetros.

Respuestas

200Account-level review source catalog.
Response
{  "data": {    "interactionSiteConfig": [      { "site": "Google", "siteUrl": "maps.google.com" },      { "site": "Facebook", "siteUrl": "facebook.com" },      { "site": "Yelp", "siteUrl": "yelp.com" }    ]  }}
401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.

Devuelve el catálogo completo de plataformas de fuentes de reseñas a las que la cuenta tiene derecho según su suscripción. La respuesta anterior es el catálogo actual de una cuenta con el plan Launch; el conjunto exacto de sitios depende del plan y del sector.

Caso de uso: validar los valores de name antes de configurar una ubicación

El campo siteUrl es el identificador canónico del sitio que se utiliza en el resto de la API de reseñas. Las fuentes de reseñas se rellenan automáticamente cuando conectas los perfiles de Google y Facebook de una ubicación; no hay ningún paso manual para añadirlas o editarlas. Usa este catálogo para descubrir los valores válidos del filtro siteUrls en el endpoint de listado de interacciones.

Caso de uso: crear una interfaz de usuario para "conectar tus reseñas"

Muestra una fila por cada sitio devuelto para que el propietario de una ubicación pueda pegar la URL de su perfil en cada plataforma. Combina este catálogo para toda la cuenta (lo que es posible) con Listar las fuentes de reseñas de una ubicación (lo que ya está conectado para una ubicación) para mostrar las fuentes conectadas frente a las disponibles.

Este endpoint no acepta parámetros y su alcance se limita a una cuenta, por lo que el resultado se mantiene estable entre llamadas; almacénalo en caché en lugar de volver a consultarlo para cada ubicación. Está sujeto al límite de solicitudes de la cuenta; si recibes 429, espera antes de volver a intentarlo según lo indicado en la cabecera Retry-After.

Request
curl -X GET 'https://listingsapi.com/api/v4/reviews/site-config' \  -H "Authorization: API $LISTINGSAPI_KEY"