list_backlink_opportunities

list_backlink_opportunities retourne les domaines où acheter un backlink peut améliorer la visibilité GEO d'un projet, associés aux offres marketplace en vigueur. Chaque ligne porte un impact score, des métriques GEO brutes (citations, fan-out searches, LLMs et prompts impliqués) et la liste des offres disponibles via les marketplaces connectés.

Quand l'utiliser

C'est le tool de link building. Sortez-le quand l'utilisateur dit "donne-moi des cibles de liens à acheter ce mois-ci", "quel est le meilleur ROI sous 500 € ?", ou "classe mes idées de backlink par ratio impact/prix". Il complète list_llm_sources en enrichissant les domaines avec des données commerciales : bestPrice, providers disponibles, liste complète des offres.

Paramètres

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet à interroger.
cursor	string	—	Cursor de pagination.
limit	integer	20	1 à 100.
filters.minImpactScore	integer	—	Impact score minimal.
filters.hasOffer	boolean	—	Restreindre aux domaines avec ou sans offres actives.
filters.priceMin	number	—	Meilleur prix minimal.
filters.priceMax	number	—	Meilleur prix maximal.
filters.providers	string[]	—	Filtre par marketplace.
filters.domainContains	string	—	Match substring case-insensitive sur le domaine.
sortBy	enum	impact_score_desc	impact_score_desc, cheapest_offer, best_impact_price_ratio, recent.

Réponse

Les lignes de data incluent l'impact score, les métriques GEO, l'offre la moins chère et la liste complète offers.items. Le bloc summary agrège les stats du portefeuille : domaines totaux, avec/sans offre, fourchette de prix.

{
  "data": [
    {
      "id": "clxbl001",
      "domain": "searchenginejournal.com",
      "impactScore": 87,
      "metrics": {
        "citationCount": 23,
        "webSearchCount": 45,
        "llmCount": 5,
        "promptCount": 18
      },
      "bestPrice": 320,
      "offers": {
        "count": 2,
        "cheapest": { "provider": "collaborator", "price": 320 },
        "items": [
          { "id": "clxoff1", "provider": "collaborator", "price": 320 },
          { "id": "clxoff2", "provider": "whitepress", "price": 410 }
        ]
      },
      "createdAt": "2026-04-01T00:00:00.000Z",
      "updatedAt": "2026-04-25T00:00:00.000Z"
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "clxbl020", "totalCount": 174 },
  "summary": {
    "totalBacklinks": 174,
    "withOffers": 98,
    "withoutOffers": 76,
    "priceStats": { "min": 80, "max": 1500, "avg": 412 }
  }
}

Conseils et patterns

• sortBy: best_impact_price_ratio est le bon défaut pour un agent à budget contraint : il fait remonter le meilleur impact par euro dépensé.
• Utilisez filters.hasOffer: true pour limiter aux domaines achetables tout de suite.
• Combinez priceMin/priceMax avec minImpactScore pour cadrer la recherche à votre budget mensuel et à votre exigence de qualité.
• Une ligne avec impactScore élevé mais offers.count à zéro reste utile : ce sont des cibles d'outreach direct, sans passage par marketplace.

Tools liés

• list_llm_sources : le signal sous-jacent (citations, fan-out) qui alimente l'impactScore.
• list_competitor_sources : trouver des domaines où des concurrents gagnent, puis vérifier s'ils existent ici comme opportunités.