Offres et options

Offres Listings et Social : services inclus, prix des options, calcul du prorata et plafonds de croissance d’un compte en libre-service.

Listings API commercialise deux produits. Listings gère les établissements et leur présence dans les annuaires. Social gère les marques et publie sur leurs comptes de réseaux sociaux. Leurs tarifs, leur facturation et leurs plafonds sont distincts.

Listings

Les tarifs des niveaux d’abonnement Listings dépendent du nombre d’établissements dont vous pouvez disposer.

Chaque établissement de l’offre bénéficie de l’ensemble du réseau d’annuaires, de la gestion des avis, des publications et des analyses. Le niveau détermine le nombre d’établissements dont vous pouvez disposer et votre quota de requêtes, mais pas les endpoints que vous pouvez appeler.

Social

Les tarifs des niveaux d’abonnement Social dépendent du nombre de connexions dont vous pouvez disposer. Une connexion correspond à un compte de réseau social — une Page Facebook, un compte Instagram Business, un compte X, une organisation LinkedIn ou un tableau Pinterest — relié à une marque sur un réseau au moyen d’un lien de connexion.

Le nombre de marques est illimité et n’est pas comptabilisé, quel que soit le niveau. Une marque est simplement le conteneur auquel appartiennent les comptes connectés et les publications diffusées depuis ces comptes ; sa création ne coûte rien et n’est jamais refusée en raison d’un plafond. POST /social/brands n’impose aucune limite de marques avec une offre API.

Ce que vous achetez, ce sont des connexions. Avec les cinq réseaux pris en charge, une marque connectée à tous les réseaux utilise cinq connexions : 20 connexions correspondent donc à environ quatre marques connectées partout, et 125 à environ vingt-cinq, mais cette répartition n’est pas imposée. Vous pouvez répartir 125 connexions entre soixante marques présentes sur deux réseaux chacune, ou les concentrer sur quelques marques.

Options

Les options sont proposées à des tarifs publics et peuvent être achetées à tout moment, sans changer de niveau.

Les packs de connexions sont cumulables. Ils s’achètent en plusieurs exemplaires : deux packs coûtent donc 50 $/mois pour 10 connexions supplémentaires, trois coûtent 75 $/mois pour 15 connexions supplémentaires, et ainsi de suite. Il n’existe aucune option par marque ni aucun moyen d’acheter une seule connexion : l’unité d’achat est de cinq. Un pack n’est pas réservé à un type de connexion : il ajoute cinq connexions au total disponible, et vous décidez à quels réseaux et à quelles marques les attribuer.

Les connexions constituent une réserve commune à l'ensemble du compte

Les connexions ne sont pas attribuées par marque. Votre niveau d'abonnement et vos packs s'additionnent pour former une réserve commune à l'ensemble du compte, dans laquelle toute marque peut puiser :

maxConnections = tier connections + (5 × connection packs)

Avec Social Growth et deux packs, un compte dispose de 125 + 10 = 135 connexions, et une marque peut en détenir 12 tandis qu'une autre en détient 1. Il n'y a aucune limite de connexions par marque : seule la réserve commune compte.

Un emplacement est consommé pour toute la période de facturation, et pas seulement tant que la connexion est active. La consommation de la réserve est mesurée selon les connexions distinctes qu'un compte a utilisées pendant la période en cours : déconnecter un canal le met donc immédiatement hors ligne, mais son emplacement reste consommé jusqu'au renouvellement de la période. C'est la même règle que pour toute autre réduction sur le compte — voir Proratisation — et cela signifie que la réserve ne peut pas être réutilisée au cours d'un même cycle : établissez 20 connexions, puis déconnectez-les, et le décompte reste à 20 jusqu'au renouvellement.

Deux conséquences en découlent. Reconnecter le même compte social à la même marque est gratuit, car cela réutilise l'emplacement que ce compte détient déjà pour cette marque. Un emplacement appartient à une paire composée d'une marque et d'un compte : rattacher le même compte à une marque différente consomme donc un deuxième emplacement, et le premier reste occupé jusqu'au cycle suivant. Et acheter un pack est le seul moyen d'ajouter de la capacité en cours de période, puisque les extensions sont facturées et mises à disposition immédiatement, tandis que les emplacements libérés attendent le cycle suivant.

GET /social/limits fournit une vue complète :

La capacité restante est de maxConnections - usage.connections. Lorsque la réserve est épuisée, le lien de connexion renvoie SY95042 : c'est pourquoi un développeur qui vient de déconnecter plusieurs comptes peut encore se voir refuser une connexion. La création de marques ne présente aucun échec équivalent avec un forfait API.

Plafonds en libre-service

Deux plafonds stricts s'appliquent, quel que soit le nombre d'extensions achetées :

• 100 établissements sur un compte Listings en libre-service.
• 250 connexions sur un compte Social en libre-service.

Il n'y a aucun plafond pour les marques : leur nombre est illimité, et un compte peut en détenir autant qu'il le souhaite tant que les connexions utilisées par ces marques restent dans les limites de la réserve.

Pour dépasser l'un ou l'autre de ces plafonds, le compte doit passer à Enterprise, où les plafonds sont négociés : contactez l'équipe commerciale plutôt que d'acheter davantage de packs. Un compte sans aucun forfait Listings ne peut pas créer d'établissements et reçoit SY10155 ; pour Social, la situation équivalente est simplement l'absence d'abonnement Social, auquel cas tous les endpoints /social/* sont indisponibles.

Ajouter le deuxième produit

Un compte qui dispose d'un produit peut acheter l'autre depuis le tableau de bord, sans contacter l'équipe commerciale et sans créer de nouveau compte. Chaque produit conserve son propre abonnement, sa propre date de renouvellement et sa propre résiliation, exactement comme si vous les aviez achetés séparément.

Chaque produit dispose de son propre essai gratuit. Le niveau Launch d'un produit auquel vous n'avez jamais souscrit commence par 14 jours gratuits, même si vous êtes déjà client payant de l'autre produit. Un client Listings Growth qui ajoute Social Launch bénéficie des 14 jours propres à Social, avec une date de renouvellement distincte, et sa facturation Listings se poursuit sans changement. Il en va de même, en sens inverse, pour un client Social qui ajoute Listings Launch.

Tous les niveaux supérieurs à Launch sont facturés le jour de l'achat, et l'offre Enterprise de chaque produit est définie avec nous plutôt que vendue en libre-service.

L'essai n'est accordé qu'une fois par produit. Si vous avez déjà essayé un produit, tout nouvel achat de ce produit est facturé immédiatement : il n'y a pas de deuxième période gratuite pour le même produit. Acheter une extension alors qu'un abonnement est encore en période d'essai met fin à cet essai et déclenche la facturation payante, ce que le tableau de bord confirme avant que cela ne se produise.

Calcul au prorata

Les options supplémentaires sont facturées immédiatement. L’achat d’un établissement supplémentaire ou d’un pack de connexions prend effet immédiatement et est facturé sur-le-champ, au prorata du temps restant dans le cycle de facturation en cours. Vous n’attendez pas le cycle suivant pour utiliser la capacité que vous venez d’acheter.

Les réductions prennent effet à la fin du cycle de facturation. Aucun élément auquel vous renoncez n’est remboursé pour le reste de la période, et aucun ne libère de capacité avant la fin du cycle. Cette règle unique couvre toutes les réductions pour chacun des deux produits :

Un emplacement de connexion libéré se comporte donc exactement comme une option supplémentaire résiliée : l’effet intervient à la fin de la période, et non lors de l’appel API. Dans l’intervalle, il est indiqué sous la forme usage.connectionsReleased dans GET /social/limits, qui vous donne une prévision de la capacité qui redeviendra disponible.

Cette asymétrie est délibérée : vous pouvez toujours augmenter votre capacité immédiatement et payer exactement ce que vous avez utilisé, et vous ne perdez jamais la capacité déjà payée — ni ne la réutilisez deux fois au cours de la même période.

La règle des 90 jours d’ancienneté

Un établissement ou une marque doit avoir au moins 90 jours d’ancienneté pour pouvoir être archivé. POST /locations/archive et POST /social/brands/archive appliquent tous deux cette règle ; le point de terminaison des marques la signale par status: "TENURE_NOT_MET" avec SY95051.

Cette règle existe parce que l’archivage permet de réduire un abonnement, et qu’une ressource créée et archivée au cours d’un même cycle ne coûterait autrement rien. Elle a une conséquence pratique à prendre en compte lors de la conception : une marque ou un établissement créé par erreur ne peut pas être supprimé pendant 90 jours. Vérifiez avant de créer.

Une fois l’ancienneté requise atteinte, le comportement diffère selon le produit :

• Les marques sont archivées immédiatement, mais leurs emplacements de connexion ne redeviennent pas disponibles immédiatement. La marque et toutes les connexions qui lui sont liées sont archivées dans la même requête et mises hors ligne immédiatement ; chacun de ces emplacements reste ensuite réservé jusqu’à la fin du cycle de facturation, exactement comme lors d’une déconnexion directe. GET /social/limits affiche la baisse de usage.connectionsActive et la hausse correspondante de usage.connectionsReleased à la lecture suivante, tandis que la valeur facturable usage.connections reste inchangée jusqu’au renouvellement. L’archivage lui-même ne comporte aucun état planifié et ne laisse rien à annuler.
• L’archivage des établissements est planifié pour la fin du cycle de facturation. L’établissement reste actif et continue d’être comptabilisé dans votre plafond Listings jusqu’à la fin du cycle, et vous pouvez revenir sur cette décision jusque-là avec annuler l’archivage d’un établissement.

Consulter vos propres limites

Vérifiez le plafond concerné avant une création plutôt qu’après un échec : vous pourrez ainsi proposer au client de passer à un forfait supérieur au lieu de lui afficher un code d’erreur.