Partner Suite

Construye sobre toda la plataforma

Una REST API con documentación en Swagger, claves con alcance por cliente y autorización OAuth 2.1. Extrae datos, envía actualizaciones e integra Synup en tu stack actual.

REST · JSON OpenAPI 3.0 OAuth 2.1 + PKCE 9 categorías

Empieza tu prueba gratis Lee la documentación

Swagger UI activa en tu panel Prueba gratis de 14 días · Sin tarjeta de crédito

at-risk-clients.js JavaScript

// Clients whose health score dropped below 60
const res = await fetch(
  'https://api.synup.com/v1/clients?health_lt=60&limit=2', {
    headers: {
      'Authorization': 'Bearer sk_live_a1b2c3d4e5f6...',
      'Content-Type': 'application/json'
    }
  }
);

const { data } = await res.json();

200 OK application/json 142 ms

{
  "data": [
    { "id": "cl_8f2ka91", "name": "Harbor Coffee",
      "health": 45, "rating": 3.6, "status": "at_risk" },
    { "id": "cl_3md7x02", "name": "Lakeside Pet Clinic",
      "health": 34, "rating": 3.1, "status": "at_risk" }
  ],
  "has_more": false
}

Las agencias construyen sobre la API de Synup

REST API

Cada recurso, una API consistente

La API de Synup sigue las convenciones REST — URLs orientadas a recursos, métodos HTTP estándar y respuestas en JSON. La interfaz de Swagger UI te ofrece una referencia navegable con la función de probar endpoints en vivo. Cubre listados, reseñas, redes sociales, GBP, analíticas, campañas y operaciones de revendedor.

RESTful, orientada a recursos, JSON de entrada y salida

Swagger UI con opción de probar en vivo para cada endpoint

Cobertura: Listados, Reseñas, Redes sociales, GBP, Analíticas, Campañas, Revendedor

Respuestas de error consistentes con códigos de estado HTTP estándar

SReferencia de la APIv1 Filtrar endpoints

Método	Endpoint	Descripción
GET	/v1/clients	Listar todos los clientes
GET	/v1/clients/:id	Obtener detalles del cliente
POST	/v1/clients	Crear un cliente
GET	/v1/clients/:id/reviews	Listar reseñas de un cliente
POST	/v1/clients/:id/posts	Crear una publicación en redes sociales
GET	/v1/clients/:id/listings	Obtener el estado del listado
GET	/v1/clients/:id/seo/rankings	Obtener rankings SEO
GET	/v1/clients/:id/aeo/visibility	Obtener puntaje de visibilidad en IA

Ver referencia completa de la API 8 de más de 140 endpoints

api.synup.com/docs

SSynup APIv1.0.4 OAS 3.0

Clientes GETPOSTPUTDEL

ReseñasGETPOST9 ops

ListadosGETPUT14 ops

Redes socialesGETPOSTDEL11 ops

Autenticación

Claves de API o OAuth 2.1 — tú eliges

Para integraciones sencillas, genera una clave de API y pásala como un token Bearer. Para aplicaciones en producción, usa OAuth 2.1 con PKCE para un acceso seguro y con alcance delimitado. El Registro Dinámico de Clientes (RFC 7591) le permite a tu aplicación registrarse de forma programática.

Autenticación con token Bearer para integraciones rápidas

OAuth 2.1 con PKCE para aplicaciones en producción

Registro Dinámico de Clientes (RFC 7591)

Tokens de acceso de 1 hora y tokens de actualización de 30 días

Scopes: mcp:read, mcp:write

Token BearerEl camino más rápido — un solo encabezado

Authorization: Bearer sk_live_a1b2c3d4e5f6...

Con alcance paraTodos los clientes

Formato de claveHex de 64 caracteres

Rota o revoca desde Configuración en cualquier momento

OAuth 2.1 + PKCEPara aplicaciones en producción

1RegistrarsePOST /oauth/mcp/registerclient_id

2AutorizarGET /oauth/mcp/authorizeconsentimiento

3TokenPOST /oauth/mcp/tokenacceso + actualización

Permisosmcp:readmcp:write

Token de acceso: 1 hora · token de actualización: 30 días

Gestión de claves

Claves con alcance por cliente

Crea claves API asignadas a ningún cliente, a todos o a clientes específicos. El agente usa la clave correcta automáticamente cuando mencionas a un cliente en el chat. Rota las claves sin interrupciones y rastrea qué clave está asignada a cada cliente.

Abre Configuración · Claves de API

SClaves API3 activas Añadir clave de API

Clave	Nombre	Vista previa	Alcance	Creada	Acciones
K01	Producción — Todos los clientesUsada por el contenedor del agente	sk_live_a1b2...f6	Todos los clientes	2026-03-11	RotarEditarEliminar
K02	Solo Bella VistaDelimitada a una cuenta de cliente	sk_live_x7y8...z9	1 cliente	2026-05-02	RotarEditarEliminar
K03	Staging (sin usar)Aún no hay clientes asignados	sk_test_m3n4...p5	Sin asignar	2026-06-19	RotarEditarEliminar

Los cambios de alcance tienen efecto en la siguiente solicitud — sin necesidad de redesplegar

Todas las claves, ID, endpoints y payloads de esta página son ejemplos ilustrativos — cámbialos por los tuyos antes de publicar.

Todo lo que necesitas para integrarte

ListadosReputaciónSocial GBPAnalíticasCampañas Localizador de tiendas y páginasGestión de clientesRevendedor

Documentación en Swagger UI

Explora cada endpoint, prueba solicitudes en vivo y consulta los esquemas de respuesta. Sin necesidad de un sitio web de documentación separado.

ClientesGETPOST

ReseñasGETPUT

Asignación de alcance de clave por cliente

Asigna cada clave a ningún cliente, a todos o a clientes específicos. El agente utiliza la clave correcta automáticamente.

sk_live_x7y8...z93 clientes

OAuth 2.1 + PKCE

Autorización de nivel de producción con registro dinámico de clientes y tokens de actualización.

1POST /oauth/mcp/register

2GET /oauth/mcp/authorize

3POST /oauth/mcp/token → 200

Rotación de claves

Genera una clave nueva y reemplázala sin tiempos de inactividad. Las claves antiguas se revocan de inmediato.

sk_live_a1b2...f6Rotar

Categorías de la API

Endpoints organizados por dominio: Listados, Reseñas, Redes sociales, GBP, Analíticas, Campañas, Revendedor.

ListadosReseñasRedes socialesGBPAnalíticasCampañasRevendedor

Sincronización de clave de Anthropic

Pega tu clave API de Anthropic una sola vez. Se sincroniza con el contenedor del agente y se redespliega automáticamente.

sk-ant-...Guardar clave

// Adrian Graphics & Marketing rollout
const results = await synup.get('/v1/campaigns/results');
// nearly every client: increased sales revenue
// many clients: 400%+ within first few months

AG Adrian Graphics & MarketingAgencia

Adrian implementó Synup rápidamente en muchos clientes de la agencia — combinando presencia, reputación y campañas a la vez. Los resultados llegaron casi de inmediato: prácticamente todos los clientes vieron un aumento en sus ingresos por ventas en los primeros meses.

Adrian Graphics & MarketingAgencia que presta servicios a Safeway, SportClips y otros

Lee la historia completa →

Preguntas frecuentes

Lo que los desarrolladores preguntan antes de hacer la primera solicitud

¿Qué puedo hacer con la API?

Extrae datos del cliente (listados, reseñas, rankings, visibilidad en IA), crea y gestiona publicaciones en redes sociales, activa escaneos, gestiona clientes y automatiza flujos de trabajo. La cobertura abarca toda la superficie de productos de Synup.

¿Cómo me autentico?

Para integraciones rápidas, usa un token Bearer (clave de API). Para aplicaciones en producción, usa OAuth 2.1 con PKCE. Ambos métodos están documentados en Swagger UI.

¿Puedo delimitar el alcance de las claves de API a clientes específicos?

Sí. Cada clave se puede asignar a ningún cliente, a todos los clientes o a un subconjunto específico. El agente usa la clave correcta de forma automática según el contexto.

¿Hay un límite de frecuencia de solicitudes?

Sí. Los límites de frecuencia están documentados por endpoint en Swagger UI. Los límites estándar son generosos para los casos de uso de integración habituales.

¿Cuál es la diferencia entre la API y MCP?

La API es REST — endpoints HTTP tradicionales para extraer datos y enviar actualizaciones. MCP es un protocolo para que los agentes de IA llamen a las herramientas de Synup de forma nativa. Usa la API para integraciones personalizadas; usa MCP para flujos de trabajo de agentes de IA.

¿Existe un SDK?

La API usa convenciones REST estándar, por lo que cualquier cliente HTTP funciona. Recomendamos usar el cliente generado por Swagger para el lenguaje de tu elección.

Empieza a construir

Crea una clave, haz una solicitud a un endpoint y lee la respuesta. Swagger UI está activa en tu panel desde el momento en que inicia tu prueba.

curl https://api.synup.com/v1/clients -H "Authorization: Bearer $SYNUP_KEY"

Empieza tu prueba gratis Lee la documentación

Sin tarjeta de crédito Sincronización en vivo en minutos Cancela en cualquier momento