Planes y complementos

Niveles de Listings y Social: qué incluyen, precio de cada complemento, prorrateo y límites de crecimiento de una cuenta de autoservicio.

Listings API vende dos productos. Listings gestiona las ubicaciones de los negocios y su presencia en directorios. Social gestiona las marcas y publica en sus cuentas de redes sociales. Sus precios, facturación y límites son independientes.

Listings

El precio de los niveles de Listings se basa en el número de ubicaciones que puedes tener.

Cada ubicación del plan dispone de toda la red de directorios, gestión de reseñas, publicaciones y analíticas. El nivel determina cuántas ubicaciones puedes tener y tu cuota de solicitudes, no qué endpoints puedes invocar.

Social

El precio de los niveles de Social se basa en el número de conexiones que puedes tener. Una conexión es una cuenta de una red social —una página de Facebook, una cuenta de empresa de Instagram, una cuenta de X, una organización de LinkedIn o un tablero de Pinterest— vinculada a una marca en una red mediante un enlace de conexión.

Las marcas son ilimitadas y no se contabilizan como consumo en ningún nivel. Una marca es simplemente el contenedor al que pertenecen las cuentas conectadas y las publicaciones realizadas desde ellas; crear una no cuesta nada y nunca se rechaza por un límite. POST /social/brands no tiene límite de marcas en un plan de API.

Lo que compras son conexiones. Las 5 redes compatibles implican que una marca conectada a todas ellas consume 5 conexiones, por lo que 20 conexiones equivalen aproximadamente a 4 marcas conectadas a todas las redes, y 125 equivalen aproximadamente a 25, pero nada obliga a distribuirlas así. Puedes repartir 125 conexiones entre 60 marcas en 2 redes cada una, o concentrarlas en unas pocas.

Complementos

Los complementos tienen precios publicados y se pueden comprar en cualquier momento, sin cambiar de nivel.

Los paquetes de conexiones son acumulables. Se compran por cantidad, de modo que 2 paquetes cuestan $50/mes por 10 conexiones adicionales, 3 cuestan $75/mes por 15, y así sucesivamente. No hay complementos por marca ni forma de comprar una sola conexión: la unidad de compra es de 5. Un paquete no está asignado a ningún tipo: añade 5 conexiones al total disponible y tú decides a qué redes y marcas destinarlas.

Las conexiones forman un cupo compartido por toda la cuenta

Las conexiones no se asignan por marca. Tu nivel y tus paquetes se suman para formar un único cupo para toda la cuenta del que puede disponer cualquier marca:

maxConnections = tier connections + (5 × connection packs)

Con Social Growth y dos paquetes, una cuenta tiene 125 + 10 = 135 conexiones disponibles, y una marca puede ocupar doce de ellas mientras otra ocupa una. No hay ningún límite de conexiones por marca: solo el cupo compartido.

Una plaza se consume durante todo el período de facturación, no solo mientras la conexión está activa. El consumo del cupo se mide por las conexiones distintas que una cuenta ha utilizado durante el período actual, por lo que desconectar un canal lo desactiva de inmediato, pero su plaza sigue consumida hasta que se renueva el período. Es la misma regla que se aplica a cualquier otra reducción en la cuenta —consulta Prorrateo— e implica que el cupo no se puede reutilizar dentro de un mismo ciclo: si estableces 20 conexiones y luego las desconectas, seguirás teniendo 20 consumidas hasta la renovación.

De esto se desprenden dos cosas. Volver a vincular la misma cuenta de una red social a la misma marca es gratis, porque reutiliza la plaza que esa cuenta ya ocupa en esa marca. Una plaza pertenece a una pareja de marca y cuenta, por lo que vincular la misma cuenta a una marca diferente consume una segunda plaza, y la primera sigue ocupada hasta que comienza el siguiente ciclo. Además, comprar un paquete es la única forma de añadir capacidad a mitad del período, ya que los complementos se cobran y se habilitan de inmediato, mientras que las plazas liberadas deben esperar al siguiente ciclo.

GET /social/limits muestra toda la información:

La capacidad disponible es maxConnections - usage.connections. Cuando se agota el cupo, la vinculación de conexiones devuelve SY95042, por lo que un desarrollador que acaba de desconectar varias cuentas puede seguir recibiendo un rechazo. La creación de marcas no tiene un fallo equivalente en un plan de API.

Límites de autoservicio

Se aplican dos límites máximos independientemente de cuántos complementos se compren:

• 100 ubicaciones en una cuenta de Listings de autoservicio.
• 250 conexiones en una cuenta de Social de autoservicio.

No hay límite de marcas: las marcas son ilimitadas y una cuenta puede tener tantas como quiera, siempre que las conexiones que utilicen esas marcas se mantengan dentro del cupo compartido.

Para superar cualquiera de estos límites, la cuenta debe pasar a Enterprise, donde los límites se negocian; contacta con ventas en lugar de comprar más paquetes. Una cuenta que no tenga ningún plan de Listings no puede crear ubicaciones y recibe SY10155; el equivalente en Social es simplemente no tener una suscripción a Social, en cuyo caso ningún endpoint de /social/* está disponible.

Añadir el segundo producto

Una cuenta que tiene un producto puede comprar el otro desde el panel, sin hablar con ventas y sin crear una cuenta nueva. Cada producto mantiene su propia suscripción, su propia fecha de renovación y su propia cancelación, exactamente igual que si los hubieras comprado por separado.

Cada producto tiene su propia prueba gratuita. El nivel Launch de un producto que nunca has tenido comienza con 14 días gratis, aunque ya seas cliente de pago del otro producto. Un cliente de Listings Growth que añade Social Launch obtiene los 14 días propios de Social con su propia fecha de renovación, y la facturación de Listings continúa sin cambios. Lo mismo se aplica a la inversa a un cliente de Social que añade Listings Launch.

Todos los niveles superiores a Launch se facturan el día de la compra, y el alcance de Enterprise para cualquiera de los dos productos se define con nosotros en lugar de contratarse mediante autoservicio.

La prueba solo se ofrece una vez por producto. Si ya has probado un producto, volver a comprarlo genera un cargo inmediato: no hay un segundo período gratuito para el mismo producto. Comprar un complemento mientras una suscripción sigue en período de prueba pone fin a esa prueba e inicia la facturación de pago, algo que el panel confirma antes de que ocurra.

Prorrateo

Los complementos se cobran de inmediato. La compra de una ubicación adicional o de un paquete de conexiones surte efecto al instante y se factura en ese momento, con el importe prorrateado por el tiempo restante del ciclo de facturación actual. No tienes que esperar al siguiente ciclo para usar la capacidad que acabas de comprar.

Las reducciones surten efecto al final del ciclo de facturación. No se reembolsa nada de lo que des de baja por el tiempo restante del período, y nada de lo que des de baja libera capacidad antes de que termine el ciclo. Esta única regla se aplica a todas las reducciones en cualquiera de los dos productos:

Por tanto, una plaza de conexión liberada se comporta exactamente igual que un complemento cancelado: el efecto se produce al finalizar el período, no al realizar la llamada a la API. Mientras esperas, se muestra como usage.connectionsReleased en GET /social/limits, que es tu previsión de la capacidad que recuperarás.

Esta asimetría es deliberada: siempre puedes ampliar la capacidad de inmediato y pagar exactamente por lo que hayas usado, y nunca pierdes capacidad por la que ya has pagado ni la reutilizas dos veces en el mismo período.

La regla de antigüedad de 90 días

Una ubicación o una marca debe tener al menos 90 días de antigüedad para poder archivarse. Tanto POST /locations/archive como POST /social/brands/archive aplican esta regla; el endpoint de marcas la comunica como status: "TENURE_NOT_MET" con SY95051.

La regla existe porque el archivado es la forma de reducir una suscripción y, de lo contrario, un recurso creado y archivado dentro de un mismo ciclo no tendría ningún coste. Tiene una consecuencia práctica que conviene tener en cuenta al diseñar: una marca o una ubicación creada por error no se puede eliminar durante 90 días. Valida antes de crear.

Lo que ocurre una vez cumplida la antigüedad mínima varía según el producto:

• Las marcas se archivan de inmediato, pero sus plazas de conexión no se recuperan de inmediato. La marca y todas las conexiones vinculadas a ella se archivan en la misma solicitud y se desconectan al instante; cada una de esas plazas queda retenida hasta el final del ciclo de facturación, exactamente igual que con una desconexión directa. GET /social/limits muestra la disminución de usage.connectionsActive y el aumento correspondiente de usage.connectionsReleased en la siguiente lectura, mientras que el valor facturable de usage.connections permanece sin cambios hasta la renovación. El archivado en sí no tiene un estado programado ni nada que cancelar.
• El archivado de las ubicaciones se programa para el final del ciclo de facturación. La ubicación sigue activa y continúa contabilizándose para tu límite de Listings hasta que termina el ciclo, y puedes revertir la decisión hasta entonces mediante cancelar el archivado de una ubicación.

Consultar tus propios límites

Comprueba el límite correspondiente antes de crear un recurso, en lugar de hacerlo después de un fallo: así podrás mostrar al cliente una opción para ampliar su plan en lugar de un código de error.