pip install requests

import requests
import json
from datetime import datetime

# Configuration
API_BASE = "https://app.linkuma.com/api/v1"
API_TOKEN = "VOTRE_TOKEN_ICI"

HEADERS = {
    "Authorization": f"Bearer {API_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json"
}


def get_projects():
    """Récupère la liste de vos projets Linkuma."""
    response = requests.get(f"{API_BASE}/projects", headers=HEADERS)
    response.raise_for_status()
    return response.json()["data"]


def place_order(project_id: str, target_url: str, anchor: str, budget: int):
    """
    Passe une commande de backlink.

    Args:
        project_id : ID du projet Linkuma
        target_url : URL de destination du lien
        anchor     : Texte d'ancre souhaité
        budget     : Budget max en euros (7 à 140)
    """
    payload = {
        "project_id": project_id,
        "target_url": target_url,
        "anchor": anchor,
        "budget_max": budget,
        "niche": "auto"  # Linkuma choisit automatiquement le site le plus pertinent
    }

    response = requests.post(
        f"{API_BASE}/orders",
        headers=HEADERS,
        json=payload
    )
    response.raise_for_status()
    return response.json()


def get_order_status(order_id: str):
    """Vérifie le statut d'une commande."""
    response = requests.get(f"{API_BASE}/orders/{order_id}", headers=HEADERS)
    response.raise_for_status()
    return response.json()["data"]


# --- Exemple d'utilisation ---
if __name__ == "__main__":

    # 1. Lister les projets disponibles
    projects = get_projects()
    print(f"Projets disponibles : {len(projects)}")
    for p in projects:
        print(f"  - {p['name']} (ID: {p['id']})")

    # 2. Passer une commande
    order = place_order(
        project_id=projects[0]["id"],
        target_url="https://monsite.fr/categorie/running",
        anchor="chaussures de running pas cher",
        budget=35
    )
    order_id = order["data"]["order_id"]
    print(f"\nCommande créée : {order_id}")

    # 3. Vérifier le statut
    status = get_order_status(order_id)
    print(f"Statut : {status['status']}")
    print(f"Créée le : {status['created_at']}")

// linkuma-monitor.mjs
// Usage : node linkuma-monitor.mjs

const API_BASE = "https://app.linkuma.com/api/v1";
const API_TOKEN = "VOTRE_TOKEN_ICI";

const headers = {
  Authorization: `Bearer ${API_TOKEN}`,
  "Content-Type": "application/json",
  Accept: "application/json",
};

/**
 * Récupère toutes les commandes selon un statut donné.
 * @param {string} status - pending | in_progress | delivered | cancelled
 */
async function getOrders(status = "in_progress") {
  const url = new URL(`${API_BASE}/orders`);
  url.searchParams.set("status", status);
  url.searchParams.set("limit", "100");

  const res = await fetch(url.toString(), { headers });
  if (!res.ok) throw new Error(`API error: ${res.status} ${res.statusText}`);
  return res.json();
}

/**
 * Affiche un résumé coloré dans le terminal.
 */
function printSummary(orders) {
  const total = orders.meta?.total ?? orders.data.length;
  console.log(`\n=== Linkuma Monitor : ${new Date().toLocaleString("fr-FR")} ===`);
  console.log(`Commandes en cours : ${total}\n`);

  for (const order of orders.data) {
    const statusIcon = order.status === "delivered" ? "✅" : "⏳";
    console.log(
      `${statusIcon} [${order.order_id}] ${order.target_url}, ${order.anchor} (${order.amount}€)`
    );
  }
}

/**
 * Boucle de monitoring : interroge l'API toutes les 5 minutes.
 */
async function startMonitor(intervalMs = 5 * 60 * 1000) {
  console.log("Démarrage du monitoring Linkuma...");

  const run = async () => {
    try {
      const orders = await getOrders("in_progress");
      printSummary(orders);
    } catch (err) {
      console.error("Erreur API Linkuma :", err.message);
    }
  };

  await run(); // Premier appel immédiat
  setInterval(run, intervalMs);
}

startMonitor();

// Google Apps Script : Linkuma Reporting
// Coller dans Extensions → Apps Script

const LINKUMA_TOKEN = "VOTRE_TOKEN_ICI";
const LINKUMA_BASE = "https://app.linkuma.com/api/v1";

function syncLinkuma() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Commandes")
    || SpreadsheetApp.getActiveSpreadsheet().insertSheet("Commandes");

  // En-têtes
  const headers = [
    "ID Commande", "Projet", "URL cible", "Ancre",
    "Statut", "Montant (€)", "Créée le", "Livrée le"
  ];

  const response = UrlFetchApp.fetch(`${LINKUMA_BASE}/orders?limit=200`, {
    method: "GET",
    headers: {
      Authorization: `Bearer ${LINKUMA_TOKEN}`,
      Accept: "application/json"
    },
    muteHttpExceptions: true
  });

  if (response.getResponseCode() !== 200) {
    Logger.log("Erreur API : " + response.getContentText());
    return;
  }

  const data = JSON.parse(response.getContentText());
  const orders = data.data || [];

  // Écriture dans le sheet
  sheet.clearContents();
  sheet.appendRow(headers);

  orders.forEach(order => {
    sheet.appendRow([
      order.order_id,
      order.project_name,
      order.target_url,
      order.anchor,
      order.status,
      order.amount,
      order.created_at ? new Date(order.created_at).toLocaleDateString("fr-FR") : "",
      order.delivered_at ? new Date(order.delivered_at).toLocaleDateString("fr-FR") : ""
    ]);
  });

  // Mise en forme
  const range = sheet.getRange(1, 1, 1, headers.length);
  range.setBackground("#1a1a2e").setFontColor("#ffffff").setFontWeight("bold");

  Logger.log(`Synchronisation terminée : ${orders.length} commandes importées.`);
}