Le guide de l'API BuyLinksForSEO

Connectez la recherche d'éditeurs et les commandes de backlinks à vos propres outils. Cette référence couvre l'authentification, les formats de requête, le flux commande-publication et les réponses. Vos intégrations utilisent le même solde et les mêmes commandes que votre compte BuyLinksForSEO.

Obtenir votre clé APIConnecter un agent IA (MCP) →

URL de base et authentification

  • URL de base https://buylinksforseo.com
  • Préfixe de version /v1
  • Auth Authorization: Bearer <your_api_key> (ou ?api_key=…)
  • Type de contenu application/json

Créez et copiez des clés dans votre tableau de bord → API. Une clé appartient à un seul compte et agit sur ce compte. L'API peut tout faire sauf recharger votre solde — l'ajout de fonds reste dans le tableau de bord.

Format de réponse

Chaque réponse est au format JSON. Enveloppes de succès et d'erreur :

{ "success": true, "data": { … } }
{ "success": false, "error": { "code": "unauthorized", "message": "…" } }

Points de terminaison

GET/v1/me

Votre compte.

{ "success": true, "data": { "id": 123, "email": "[email protected]", "name": "You", "balance": 45.00 } }
GET/v1/balance

Solde actuel du compte (USD).

GET/v1/donors

Sites donneurs de la Marketplace (paginés, 20/page). Paramètres de requête optionnels : page, domain_filter, ext_filter, dr_min, referring_domains_min, price_filter, top100_filter.

{ "success": true, "data": [ { "id": 42, "domain": "blog.com", "dr": 61, "price": 12 } ],
  "pagination": { "current_page": 1, "total_pages": 478, "total_records": 9543 } }
GET/v1/article-prompt

Renvoie l'invite exacte que nous utilisons pour rédiger l'article — vous pouvez la lire et la modifier. Paramètres de requête facultatifs : keyword, target_url, language, recommendations. Modifiez le prompt renvoyé et repassez-le à POST /v1/orders comme recommendations; conservez le OUTPUT FORMAT bloc et il s'exécute tel quel.

{ "success": true, "data": { "default_prompt": "…", "editable_field": "recommendations",
    "modes": { "own": "…", "prompt": "…", "auto": "…" } } }
POST/v1/orders

Créez votre/vos commande(s) de backlinks dans votre panier — pas encore facturé. donor_ids est toujours requis ; puis choisissez l'un des trois modes de contenu:

  • Auto — envoyer target_url + keyword; nous recherchons et rédigeons l'article.
  • Depuis votre prompt — envoie aussi recommendations (récupérer et modifier le prompt de base via GET /v1/article-prompt) ; nous rédigeons selon votre brief.
  • Votre propre article — envoyer content (+ optionnel title, article_url) ; nous publions votre HTML prêt à l'emploi tel quel. Nécessite que le contenu personnalisé soit activé sur votre compte.
// auto
{ "donor_ids": [42, 43], "target_url": "https://you.com/pricing", "keyword": "best crm", "language": "en" }
// from your prompt
{ "donor_ids": [42], "target_url": "https://you.com", "keyword": "best crm", "recommendations": "Friendly tone, cite 2 studies…" }
// your own article
{ "donor_ids": [42], "content": "<article>…</article>", "title": "My headline" }
{ "success": true, "data": { "mode": "auto", "order_content_ids": [9001, 9002],
    "basket_ids": [55, 56], "total_price": 24, "status": "in_basket" } }
GET/v1/basket

Vérifiez ce qui se trouve actuellement dans votre panier (articles rédigés, donneur, prix) avant de publier.

POST/v1/basket/pay

Publiez tout votre panier, en payant depuis le solde de votre compte. Si le solde est insuffisant, rien n'est publié et tout est retourné success:false avec le montant encore nécessaire. La recharge se fait uniquement via le tableau de bord.

{ "success": true, "data": { "status": "published", "charged": 24, "links": 2 } }
GET/v1/links

Vos liens commandés (backlinks) avec statut et URL publiée. /v1/orders (GET) est un alias.

{ "success": true, "count": 1, "data": [
  { "id": 8891, "target_url": "https://you.com/pricing", "keyword": "best crm",
    "status": "active", "published_url": "https://donor.com/…?aio-…", "cost": "12.00" } ] }

Flux de commande

  1. Trouver des sites — GET /v1/donors pour choisir des donneurs pertinents à trafic réel.
  2. Commande — POST /v1/orders avec les identifiants des donneurs et votre page/mot-clé → les éléments arrivent dans votre panier. Choisissez le mode de contenu : auto, votre prompt modifié (recommendations, voir GET /v1/article-prompt), ou votre propre content.
  3. Avis — GET /v1/basket pour vérifier les brouillons et le total.
  4. Publier — POST /v1/basket/pay paye à partir de votre solde et met les liens en ligne (~24h).
  5. Suivre — GET /v1/links pour le statut et les URL publiées.

Erreurs

  • 401 unauthorized — clé manquante / invalide / révoquée
  • 400 bad_request / payment_failed — corps invalide, ou le solde ne couvre pas le panier
  • 403 forbidden / own_content_disabled — la clé ne peut pas commander, ou le contenu propriétaire n’est pas activé sur votre compte
  • 404 not_found — point de terminaison ou ressource inconnu
  • 405 method_not_allowed
  • 500 server_error — transitoire ; réessayer

Pour les agents IA : authentifiez-vous avec la clé Bearer, appelez GET /v1/me pour confirmer le compte, GET /v1/donors pour trouver des sites, puis POST /v1/orders → POST /v1/basket/pay pour commander et publier. Ou ignorez complètement HTTP et utilisez le Serveur MCP — même clé, outils natifs.