DocumentationRéférence de l'API
Liens entrants
Les liens entrants (backlinks) d'un site, et leur actualisation.
Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).
| Opération | Appel | |
|---|---|---|
| Récupérer les liens entrants | GET /sites/{siteId}/backlinks | Gratuit |
| Actualiser les liens entrants | POST /sites/{siteId}/backlinks | Facturé |
Récupérer les liens entrants
/sites/{siteId}/backlinksGratuitLe profil de liens entrants enregistré du site : ses chiffres, les principaux domaines référents, ancres et backlinks, la comparaison avec ses principaux concurrents et les opportunités de liens manquants. null jusqu'à une première actualisation.
- stale vaut true dès que le profil a plus de 7 jours : refresh_backlinks le met à jour.
- probable_spam : les domaines référents qui ressemblent à du spam (fermes de liens, domaines jetables, casinos, aucune autorité transmise), tenus à l'écart de referring_domains et jamais dans opportunities.
Outil MCP get_backlinks
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/backlinks \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Actualiser les liens entrants
/sites/{siteId}/backlinksFacturéRécupérer à nouveau le profil de liens entrants du site (le site et ses 3 principaux concurrents), l'enregistrer et le renvoyer.
- Facturé par appel de données, exactement comme le bouton Actualiser de l'app : environ 10 appels.
- 402 INSUFFICIENT_TOKENS quand les crédits ne couvrent pas le cas le plus coûteux de l'actualisation, 409 CONFLICT pendant qu'une actualisation est en cours pour le site.
Outil MCP refresh_backlinks
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/backlinks \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Une question sans réponse ici ? Écrivez-nous.

