API et serveur MCP GetLinkFast

À quoi ça sert

• Agences et équipes SEO : branchez vos outils internes et vos tableaux de suivi sur votre compte. Catalogue, panier, commandes et statuts se lisent en JSON.
• Agents IA : demandez à Claude Code ou Cursor « trouve-moi 5 sites finance DR 40+ et commande ». L'agent cherche, vous montre le récapitulatif et ne commande qu'après votre accord.
• Make, n8n, Zapier : un module HTTP et une clé suffisent.

L'API vend l'article invité (guest_post), l'insertion de lien (link_insertion) et les packs SEO/GEO, en crédits uniquement. L'achat de crédits et les autres offres restent dans le tableau de bord.

Créer une clé

1. Ouvrez Tableau de bord → Accès API.
2. Nommez la clé (par exemple « Agent Claude » ou « Reporting Make ») et choisissez ses droits. Sur une clé qui peut commander, vous pouvez fixer un plafond par commande et un plafond sur 24 heures.
3. Copiez la clé. Elle commence par glf_live_ et ne s'affiche qu'une seule fois : nous n'en gardons qu'une empreinte.
4. Envoyez-la dans l'en-tête de chaque requête : Authorization: Bearer glf_live_…

10 clés actives au maximum par organisation. Une clé révoquée cesse aussitôt de fonctionner, tout comme les clés d'un membre qui quitte l'organisation. Gardez la clé hors de vos dépôts de code : quiconque la détient agit au nom de votre organisation.

Les droits d'une clé

Chaque clé porte un ou plusieurs droits. Une requête sans le droit nécessaire reçoit 403 insufficient_scope, et un agent IA ne voit que les outils permis.

Démarrage rapide

Toutes les routes commencent par https://www.getlinkfast.com/api/v1. Gardez le www : l'adresse sans www redirige, et un client HTTP n'envoie plus l'en-tête Authorization après une redirection.

Les montants sont en euros hors TVA. Les réponses sont en JSON, les champs en snake_case.

curl https://www.getlinkfast.com/api/v1/account \
  -H "Authorization: Bearer glf_live_…"

curl "https://www.getlinkfast.com/api/v1/sites?dr_min=40&language=fr&product=guest_post&sort=dr&dir=desc&page_size=10" \
  -H "Authorization: Bearer glf_live_…"

curl -X POST https://www.getlinkfast.com/api/v1/cart/items \
  -H "Authorization: Bearer glf_live_…" \
  -H "Content-Type: application/json" \
  -d '{"site_id":"8a1f0c3e-5b7d-4e2a-9c61-0f3b2d4e6a17","product_type":"guest_post","target_url":"https://www.example.com/invoicing","anchor":"invoicing software","topic":"How to choose invoicing software for a small business"}'

Remplacez site_id par l'id d'un site de l'étape 2. N'envoyez jamais de prix : le serveur le calcule.

curl -X POST https://www.getlinkfast.com/api/v1/checkout \
  -H "Authorization: Bearer glf_live_…" \
  -H "Idempotency-Key: order-2026-10-14-001"

La réponse donne l'id de la commande, le montant débité et votre solde restant. Suivez ensuite son avancement avec GET /orders/{id}.

Commander en crédits

L'API commande uniquement en crédits et ne déclenche jamais de paiement par carte. Les crédits se rechargent dans le tableau de bord.

Une commande prend les lignes guest_post et link_insertion du panier. Les autres lignes, ajoutées depuis le tableau de bord, restent au panier et sont listées dans skipped_items.

Aucun plafond par défaut : votre solde est la seule limite. Sur une clé qui peut commander, fixez un plafond par commande et un plafond sur 24 heures glissantes. Une commande qui les dépasse est refusée (403 spending_limit_exceeded, avec le reste disponible), sans débit.

Solde insuffisant : 402 insufficient_credits, avec le montant manquant et le lien de la page Crédits, à transmettre à une personne de votre équipe. Rien n'est débité.

Ensuite, tout se passe comme depuis le tableau de bord : email de confirmation et suivi dans l'écran Commandes, où la commande porte le nom de la clé qui l'a passée.

L'en-tête Idempotency-Key

• Obligatoire sur POST /checkout et POST /packs/orders : de 8 à 128 caractères ASCII imprimables, sans espace. Sans lui : 400 idempotency_key_required.
• Une valeur égale une intention d'achat. Renvoyer la même valeur rend la commande d'origine (200, "replayed": true) sans second débit, même si le panier a changé depuis.
• Après un délai dépassé ou une coupure réseau, relancez avec la même valeur : vous ne paierez pas deux fois.
• Pour un nouvel achat, générez une nouvelle valeur, un UUID par exemple.
• Sur POST /checkout comme sur POST /packs/orders, une valeur qui a déjà servi à un autre achat est refusée : 409 idempotency_conflict, sans débit. Pour un pack, la même valeur envoyée avec un autre contenu l'est aussi.
• Côté MCP, le jeton de confirmation joue ce rôle : vous n'avez rien à générer.

Limites

• 120 requêtes par minute et par clé pour la lecture, et autant, séparément, pour le panier : l'une n'entame pas l'autre.
• 10 appels par minute et par clé vers les routes ou outils d'achat — rejeux, refus et étape de récapitulatif MCP compris.
• 300 requêtes HTTP par minute et par clé sur le serveur MCP. Chaque outil appelé compte en plus dans la limite de son droit.
• Au-delà : 429 rate_limited. L'attente, en secondes, est donnée par l'en-tête Retry-After en HTTP, et par details.retry_after_seconds dans le résultat d'un outil MCP.
• 100 résultats par page au maximum (page_size).
• Corps de requête : 1 Mo au maximum.

Codes d'erreur

Toute erreur a la même forme. Testez code : il est stable. message est en anglais et s'adresse au développeur ; details précise le champ fautif ou les montants.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this order. Nothing was debited. Ask a human to top up at credits_url, then retry with the same Idempotency-Key.",
    "details": {
      "missing_amount": 42,
      "credits_url": "https://www.getlinkfast.com/dashboard/credits"
    }
  }
}

Serveur MCP

Le serveur MCP donne à votre agent IA les mêmes fonctions que l'API, avec la même clé. Son adresse : https://www.getlinkfast.com/api/mcp.

Claude Code

Une commande dans votre terminal :

claude mcp add --transport http getlinkfast https://www.getlinkfast.com/api/mcp --header "Authorization: Bearer glf_live_…"

Cursor

Dans ~/.cursor/mcp.json. Évitez le fichier .cursor/mcp.json d'un projet : il finit souvent dans le dépôt, avec la clé.

{
  "mcpServers": {
    "getlinkfast": {
      "url": "https://www.getlinkfast.com/api/mcp",
      "headers": {
        "Authorization": "Bearer glf_live_…"
      }
    }
  }
}

Claude Desktop

Claude Desktop n'envoie pas d'en-tête personnalisé à un serveur distant : il ne peut donc pas transmettre votre clé. Il se branchera nativement avec la connexion OAuth, prévue dans une prochaine version. Aujourd'hui, utilisez Claude Code ou Cursor : ils envoient la clé dans l'en-tête Authorization.

Les outils

L'agent ne voit que les outils permis par les droits de la clé : une clé sans le droit de commander n'a aucun outil d'achat.

read

search_sitesget_sitelist_site_pageslist_categoriesget_accountlist_ordersget_orderget_auditquote_packlist_auditsget_plan

cart

get_cartadd_to_cartupdate_cart_itemremove_cart_itemadd_audit_pagerun_auditcancel_planned_link

purchase

checkoutorder_packplan_links

L'achat en deux temps

1. L'agent appelle checkout ou order_pack sans confirmation_token : rien n'est débité. Il reçoit le récapitulatif (lignes, total, solde après débit, plafond restant) et un confirmation_token.
2. Il vous montre ce récapitulatif. Si vous acceptez, il rappelle l'outil avec le confirmation_token : la commande est passée et débitée.
3. Le jeton vaut 10 minutes. Si le panier, un prix ou la clé change entre-temps, il est refusé (confirmation_expired) et l'agent refait l'étape 1. Rappeler avec le même jeton après une coupure rend la même commande, sans second débit.

Client écrit à la main

Le serveur est sans session : chaque message JSON-RPC part en POST et la réponse arrive en JSON. Envoyez Accept: application/json, text/event-stream et Content-Type: application/json, sinon le serveur répond 406. GET et DELETE répondent 405.

curl -X POST https://www.getlinkfast.com/api/mcp \
  -H "Authorization: Bearer glf_live_…" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Auditer et planifier

Un agent peut auditer un site, puis étaler des liens sur plusieurs mois à partir du rapport. Quatre étapes, avec les outils du serveur MCP.

1. run_audit lance l'audit complet d'un domaine : contrôles techniques, visibilité dans ChatGPT et sites où un lien aiderait. Comptez quelques minutes. Rien n'est débité, et le rapport est débloqué avec le quota d'audits de l'organisation quand elle en a un. Limite : 10 audits par clé et par 24 heures ; le même domaine redemandé dans l'heure rend l'audit existant.
2. get_audit rend l'état et l'étape en cours, puis le rapport dans summary quand le statut passe à ready. Rappelez-le toutes les 30 à 60 secondes. list_audits liste les audits de l'organisation, du plus récent au plus ancien.
3. plan_links prépare un calendrier à partir d'un audit prêt : un budget mensuel en euros hors TVA (au moins 100 €), de 2 à 12 mois, et en option une date de départ et les pages visées. Comme pour l'achat, deux temps. Sans jeton, rien n'est enregistré : l'agent reçoit le calendrier (liens, dates d'envoi, total) et un confirmation_token valable 10 minutes. Après votre accord, il rappelle l'outil avec les mêmes champs et le jeton, et le plan est enregistré.
4. get_plan suit chaque lien : page visée, ancre, prix et état (programmé, commandé, publié, annulé ou échoué, avec la cause d'un échec comme insufficient_credits). cancel_planned_link annule un lien planifié par l'API, ou tous ceux d'un domaine pas encore commandés. Les liens programmés par notre équipe restent en place : team_planned pour un lien, skipped_team_planned pour leur nombre.

Rien n'est débité à l'enregistrement du plan. Chaque lien est débité en crédits le jour de son envoi, au prix relu ce jour-là, lors du passage quotidien du matin (vers 06:20 UTC). Si le solde manque ce jour-là, le lien n'est pas commandé et apparaît en échec dans get_plan. Un lien déjà commandé ne s'annule plus.

Droits : run_audit et cancel_planned_link demandent le droit cart, plan_links le droit purchase, et get_audit, list_audits et get_plan le droit read. Les plafonds de dépense de la clé s'appliquent aux liens planifiés.

Dans le tableau de bord, la page Délégation affiche ces liens dans le bloc « Liens programmés ». Le propriétaire de l'organisation peut y retirer les liens planifiés par l'API. Ceux que notre équipe a planifiés se lisent seulement.

Référence

Chaque route avec son droit et l'outil MCP qui lui correspond. Paramètres, schémas de réponse et erreurs route par route : la description OpenAPI 3.1.

Une question sur l'API ? Écrivez-nous, une personne de l'équipe vous répond.