GetLinkFast API und MCP-Server

Wofür es gedacht ist

• Agenturen und SEO-Teams: Verbinden Sie Ihre internen Tools und Tracking-Dashboards mit Ihrem Konto. Katalog, Warenkorb, Bestellungen und Status lassen sich als JSON lesen.
• KI-Agenten: Bitten Sie Claude Code oder Cursor: „Finde mir 5 Finanz-Websites mit DR 40+ und bestelle sie.“ Der Agent sucht, zeigt Ihnen die Zusammenfassung und bestellt erst nach Ihrer Zustimmung.
• Make, n8n, Zapier: Ein HTTP-Modul und ein Schlüssel genügen.

Die API verkauft Gastartikel (guest_post), Link-Einfügungen (link_insertion) und SEO/GEO-Pakete, ausschließlich gegen Credits. Der Kauf von Credits und die übrigen Angebote bleiben im Dashboard.

Einen Schlüssel erstellen

1. Öffnen Sie Dashboard → API-Zugang.
2. Benennen Sie den Schlüssel (zum Beispiel „Claude-Agent“ oder „Make-Reporting“) und wählen Sie seine Berechtigungen. Für einen Schlüssel, der bestellen darf, können Sie ein Limit pro Bestellung und ein Limit über 24 Stunden festlegen.
3. Kopieren Sie den Schlüssel. Er beginnt mit glf_live_ und wird nur ein einziges Mal angezeigt: Wir speichern nur einen Hash davon.
4. Senden Sie ihn im Header jeder Anfrage: Authorization: Bearer glf_live_…

Höchstens 10 aktive Schlüssel pro Organisation. Ein widerrufener Schlüssel funktioniert sofort nicht mehr, ebenso die Schlüssel eines Mitglieds, das die Organisation verlässt. Halten Sie den Schlüssel aus Ihren Code-Repositorys heraus: Wer ihn besitzt, handelt im Namen Ihrer Organisation.

Die Berechtigungen eines Schlüssels

Jeder Schlüssel trägt eine oder mehrere Berechtigungen. Eine Anfrage ohne die nötige Berechtigung erhält 403 insufficient_scope, und ein KI-Agent sieht nur die erlaubten Tools.

Schnellstart

Alle Routen beginnen mit https://www.getlinkfast.com/api/v1. Behalten Sie das www: Die Adresse ohne www leitet weiter, und ein HTTP-Client sendet nach einer Weiterleitung den Header Authorization nicht mehr.

Beträge in Euro ohne MwSt. Antworten sind JSON, Felder in 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"}'

Ersetzen Sie site_id durch die ID einer Website aus Schritt 2. Senden Sie nie einen Preis: Der Server berechnet ihn.

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

Die Antwort enthält die Bestell-ID, den abgebuchten Betrag und Ihr Restguthaben. Verfolgen Sie den Fortschritt anschließend mit GET /orders/{id}.

Mit Credits bestellen

Die API bestellt ausschließlich mit Credits und löst nie eine Kartenzahlung aus. Credits werden im Dashboard aufgeladen.

Eine Bestellung übernimmt die Positionen guest_post und link_insertion aus dem Warenkorb. Andere Positionen, die über das Dashboard hinzugefügt wurden, bleiben im Warenkorb und werden in skipped_items aufgeführt.

Standardmäßig kein Limit: Ihr Guthaben ist die einzige Grenze. Für einen Schlüssel, der bestellen darf, legen Sie ein Limit pro Bestellung und ein Limit über gleitende 24 Stunden fest. Eine Bestellung, die sie überschreitet, wird abgelehnt (403 spending_limit_exceeded, mit dem verbleibenden Betrag), ohne Abbuchung.

Guthaben unzureichend: 402 insufficient_credits, mit dem fehlenden Betrag und dem Link zur Credits-Seite, zur Weitergabe an jemanden in Ihrem Team. Es wird nichts abgebucht.

Danach läuft alles wie im Dashboard: Bestätigungs-E-Mail und Verfolgung im Bildschirm Bestellungen, wo die Bestellung den Namen des Schlüssels trägt, der sie aufgegeben hat.

Der Header Idempotency-Key

• Pflicht bei POST /checkout und POST /packs/orders: 8 bis 128 druckbare ASCII-Zeichen, ohne Leerzeichen. Ohne ihn: 400 idempotency_key_required.
• Ein Wert entspricht einer Kaufabsicht. Wird derselbe Wert erneut gesendet, kommt die ursprüngliche Bestellung zurück (200, "replayed": true), ohne zweite Abbuchung, auch wenn sich der Warenkorb inzwischen geändert hat.
• Nach einer Zeitüberschreitung oder einem Netzwerkausfall wiederholen Sie mit demselben Wert: Sie zahlen nicht doppelt.
• Erzeugen Sie für einen neuen Kauf einen neuen Wert, zum Beispiel eine UUID.
• Bei POST /checkout wie bei POST /packs/orders wird ein Wert abgelehnt, der schon für einen anderen Kauf verwendet wurde: 409 idempotency_conflict, ohne Abbuchung. Bei einem Paket gilt das auch für denselben Wert mit anderem Inhalt.
• Auf der MCP-Seite übernimmt das Bestätigungstoken diese Rolle: Sie müssen nichts erzeugen.

Limits

• 120 Anfragen pro Minute und Schlüssel zum Lesen und, getrennt davon, ebenso viele für den Warenkorb: Das eine geht nicht vom anderen ab.
• 10 Aufrufe pro Minute und Schlüssel an die Kauf-Routen oder -Tools — Wiederholungen, Ablehnungen und der MCP-Zusammenfassungsschritt eingeschlossen.
• 300 HTTP-Anfragen pro Minute und Schlüssel auf dem MCP-Server. Jedes aufgerufene Tool zählt zusätzlich zum Limit seiner Berechtigung.
• Darüber hinaus: 429 rate_limited. Die Wartezeit in Sekunden steht über HTTP im Header Retry-After und in einem MCP-Tool-Ergebnis in details.retry_after_seconds.
• Höchstens 100 Ergebnisse pro Seite (page_size).
• Anfragekörper: höchstens 1 MB.

Fehlercodes

Jeder Fehler hat dieselbe Form. Prüfen Sie code: Er ist stabil. message ist auf Englisch und richtet sich an Entwickler; details nennt das fehlerhafte Feld oder die Beträge.

{
  "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"
    }
  }
}

MCP-Server

Der MCP-Server gibt Ihrem KI-Agenten dieselben Funktionen wie die API, mit demselben Schlüssel. Seine Adresse: https://www.getlinkfast.com/api/mcp.

Claude Code

Ein Befehl in Ihrem Terminal:

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

Cursor

In ~/.cursor/mcp.json. Vermeiden Sie die Datei .cursor/mcp.json eines Projekts: Sie landet oft im Repository, samt Schlüssel.

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

Claude Desktop

Claude Desktop sendet keine benutzerdefinierten Header an einen entfernten Server und kann Ihren Schlüssel daher nicht übermitteln. Es wird sich nativ über die OAuth-Verbindung anbinden, die für eine kommende Version geplant ist. Verwenden Sie heute Claude Code oder Cursor: Sie senden den Schlüssel im Header Authorization.

Die Tools

Der Agent sieht nur die Tools, die die Berechtigungen des Schlüssels erlauben: Ein Schlüssel ohne Bestellrecht hat kein Kauf-Tool.

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

Kauf in zwei Schritten

1. Der Agent ruft checkout oder order_pack ohne confirmation_token auf: Es wird nichts abgebucht. Er erhält die Zusammenfassung (Positionen, Summe, Guthaben nach Abbuchung, verbleibendes Limit) und ein confirmation_token.
2. Er zeigt Ihnen diese Zusammenfassung. Wenn Sie zustimmen, ruft er das Tool erneut mit dem confirmation_token auf: Die Bestellung wird aufgegeben und abgebucht.
3. Das Token gilt 10 Minuten. Ändern sich zwischenzeitlich der Warenkorb, ein Preis oder der Schlüssel, wird es abgelehnt (confirmation_expired) und der Agent wiederholt Schritt 1. Ein erneuter Aufruf mit demselben Token nach einem Ausfall liefert dieselbe Bestellung, ohne zweite Abbuchung.

Selbst geschriebener Client

Der Server ist sitzungslos: Jede JSON-RPC-Nachricht geht per POST, die Antwort kommt als JSON. Senden Sie Accept: application/json, text/event-stream und Content-Type: application/json, sonst antwortet der Server mit 406. GET und DELETE antworten mit 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"}'

Auditieren und planen

Ein Agent kann eine Website auditieren und anhand des Berichts Links über mehrere Monate verteilen. Vier Schritte, mit den Tools des MCP-Servers.

1. run_audit startet das vollständige Audit einer Domain: technische Prüfungen, Sichtbarkeit in ChatGPT und Websites, bei denen ein Link helfen würde. Rechnen Sie mit einigen Minuten. Es wird nichts abgebucht, und der Bericht wird mit dem Audit-Kontingent der Organisation freigeschaltet, falls sie eines hat. Limit: 10 Audits pro Schlüssel und 24 Stunden; wird dieselbe Domain innerhalb einer Stunde erneut angefragt, kommt das bestehende Audit zurück.
2. get_audit liefert Status und aktuellen Schritt, danach den Bericht in summary, sobald der Status ready lautet. Rufen Sie es alle 30 bis 60 Sekunden auf. list_audits listet die Audits der Organisation, das neueste zuerst.
3. plan_links erstellt aus einem fertigen Audit einen Kalender: ein Monatsbudget in Euro ohne MwSt. (mindestens 100 €), 2 bis 12 Monate und optional ein Startdatum und die Zielseiten. Wie beim Kauf sind es zwei Schritte. Ohne Token wird nichts gespeichert: Der Agent erhält den Kalender (Links, Versanddaten, Summe) und ein confirmation_token, das 10 Minuten gilt. Nach Ihrer Zustimmung ruft er das Tool mit denselben Feldern und dem Token erneut auf, und der Plan wird gespeichert.
4. get_plan verfolgt jeden Link: Zielseite, Ankertext, Preis und Status (geplant, bestellt, veröffentlicht, storniert oder fehlgeschlagen, bei einem Fehlschlag mit der Ursache, etwa insufficient_credits). cancel_planned_link storniert einen über die API geplanten Link oder alle noch nicht bestellten einer Domain. Von unserem Team geplante Links bleiben bestehen: team_planned für einen Link, skipped_team_planned für ihre Anzahl.

Beim Speichern des Plans wird nichts abgebucht. Jeder Link wird am Tag seines Versands in Credits abgebucht, zum an diesem Tag neu gelesenen Preis, beim täglichen Durchlauf am Morgen (gegen 06:20 UTC). Reicht das Guthaben an diesem Tag nicht, wird der Link nicht bestellt und erscheint in get_plan als fehlgeschlagen. Ein bereits bestellter Link lässt sich nicht mehr stornieren.

Berechtigungen: run_audit und cancel_planned_link brauchen cart, plan_links braucht purchase, get_audit, list_audits und get_plan brauchen read. Die Ausgabenlimits des Schlüssels gelten auch für geplante Links.

Im Dashboard zeigt die Seite Delegation diese Links im Block „Geplante Links“. Die Inhaberin oder der Inhaber der Organisation kann dort per API geplante Links entfernen. Von unserem Team geplante Links sind nur lesbar.

Referenz

Jede Route mit ihrer Berechtigung und dem passenden MCP-Tool. Parameter, Antwortschemata und Fehler Route für Route: die OpenAPI-3.1-Beschreibung.

Eine Frage zur API? Schreiben Sie uns, eine Person aus dem Team antwortet Ihnen.