GetLinkFast API en MCP-server

Waarvoor het dient

• Bureaus en SEO-teams: koppel uw interne tools en rapportagedashboards aan uw account. Catalogus, winkelwagen, bestellingen en statussen zijn als JSON leesbaar.
• AI-agents: vraag Claude Code of Cursor „zoek 5 financiële sites met DR 40+ en bestel ze”. De agent zoekt, toont u het overzicht en bestelt pas na uw akkoord.
• Make, n8n, Zapier: een HTTP-module en een sleutel zijn genoeg.

De API verkoopt gastartikelen (guest_post), linkinvoegingen (link_insertion) en SEO/GEO-pakketten, uitsluitend met tegoed. Tegoed kopen en de overige aanbiedingen blijven in het dashboard.

Een sleutel aanmaken

1. Open Dashboard → API-toegang.
2. Geef de sleutel een naam (bijvoorbeeld „Claude-agent” of „Make-rapportage”) en kies de rechten. Op een sleutel die mag bestellen, kunt u een limiet per bestelling en een limiet over 24 uur instellen.
3. Kopieer de sleutel. Hij begint met glf_live_ en wordt maar één keer getoond: wij bewaren alleen een hash ervan.
4. Stuur hem mee in de header van elk verzoek: Authorization: Bearer glf_live_…

Maximaal 10 actieve sleutels per organisatie. Een ingetrokken sleutel werkt meteen niet meer, net als de sleutels van een lid dat de organisatie verlaat. Houd de sleutel buiten uw coderepository's: wie hem heeft, handelt namens uw organisatie.

De rechten van een sleutel

Elke sleutel heeft een of meer rechten. Een verzoek zonder het benodigde recht krijgt 403 insufficient_scope, en een AI-agent ziet alleen de toegestane tools.

Snel aan de slag

Alle routes beginnen met https://www.getlinkfast.com/api/v1. Houd de www: het adres zonder www stuurt door, en een HTTP-client stuurt na een doorverwijzing de header Authorization niet meer mee.

Bedragen zijn in euro exclusief btw. Antwoorden zijn JSON, velden 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"}'

Vervang site_id door het id van een site uit stap 2. Stuur nooit een prijs mee: de server berekent die.

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

Het antwoord bevat het id van de bestelling, het afgeschreven bedrag en uw resterende saldo. Volg daarna de voortgang met GET /orders/{id}.

Bestellen met tegoed

De API bestelt uitsluitend met tegoed en start nooit een kaartbetaling. Tegoed wordt opgewaardeerd in het dashboard.

Een bestelling neemt de regels guest_post en link_insertion uit de winkelwagen. Andere regels, toegevoegd via het dashboard, blijven in de winkelwagen en staan in skipped_items.

Standaard geen limiet: uw saldo is de enige grens. Stel op een sleutel die mag bestellen een limiet per bestelling en een limiet over voortschrijdende 24 uur in. Een bestelling die ze overschrijdt, wordt geweigerd (403 spending_limit_exceeded, met het resterende bedrag), zonder afschrijving.

Onvoldoende saldo: 402 insufficient_credits, met het ontbrekende bedrag en de link naar de pagina Tegoed, om door te geven aan iemand in uw team. Er wordt niets afgeschreven.

Daarna gaat alles zoals vanuit het dashboard: bevestigingsmail en opvolging in het scherm Bestellingen, waar de bestelling de naam draagt van de sleutel die haar plaatste.

De header Idempotency-Key

• Verplicht op POST /checkout en POST /packs/orders: 8 tot 128 afdrukbare ASCII-tekens, zonder spaties. Zonder: 400 idempotency_key_required.
• Eén waarde staat voor één aankoopintentie. Dezelfde waarde opnieuw sturen geeft de oorspronkelijke bestelling terug (200, "replayed": true) zonder tweede afschrijving, ook als de winkelwagen sindsdien is gewijzigd.
• Na een time-out of een netwerkonderbreking probeert u het opnieuw met dezelfde waarde: u betaalt niet twee keer.
• Genereer voor een nieuwe aankoop een nieuwe waarde, bijvoorbeeld een UUID.
• Op POST /checkout en op POST /packs/orders wordt een waarde die al voor een andere aankoop is gebruikt geweigerd: 409 idempotency_conflict, zonder afschrijving. Voor een pakket geldt dat ook voor dezelfde waarde met andere inhoud.
• Aan de MCP-kant vervult het bevestigingstoken deze rol: u hoeft niets te genereren.

Limieten

• 120 verzoeken per minuut per sleutel om te lezen, en evenveel, apart, voor de winkelwagen: het een gaat niet af van het ander.
• 10 aanroepen per minuut per sleutel naar de aankooproutes of -tools — herhalingen, weigeringen en de MCP-samenvattingsstap inbegrepen.
• 300 HTTP-verzoeken per minuut per sleutel op de MCP-server. Elke aangeroepen tool telt daarnaast mee in de limiet van zijn recht.
• Daarboven: 429 rate_limited. De wachttijd in seconden staat via HTTP in de header Retry-After, en in een MCP-toolresultaat in details.retry_after_seconds.
• Maximaal 100 resultaten per pagina (page_size).
• Body van het verzoek: maximaal 1 MB.

Foutcodes

Elke fout heeft dezelfde vorm. Test op code: die is stabiel. message is in het Engels en bedoeld voor de ontwikkelaar; details noemt het foute veld of de bedragen.

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

De MCP-server geeft uw AI-agent dezelfde functies als de API, met dezelfde sleutel. Het adres: https://www.getlinkfast.com/api/mcp.

Claude Code

Eén opdracht in uw terminal:

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

Cursor

In ~/.cursor/mcp.json. Vermijd het bestand .cursor/mcp.json van een project: dat belandt vaak in de repository, samen met de sleutel.

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

Claude Desktop

Claude Desktop stuurt geen aangepaste headers naar een externe server en kan uw sleutel dus niet doorgeven. Het koppelt straks rechtstreeks via de OAuth-verbinding, gepland voor een volgende versie. Gebruik vandaag Claude Code of Cursor: die sturen de sleutel in de header Authorization.

De tools

De agent ziet alleen de tools die de rechten van de sleutel toestaan: een sleutel zonder bestelrecht heeft geen aankooptool.

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

Aankoop in twee stappen

1. De agent roept checkout of order_pack aan zonder confirmation_token: er wordt niets afgeschreven. Hij krijgt het overzicht (regels, totaal, saldo na afschrijving, resterende limiet) en een confirmation_token.
2. Hij toont u dat overzicht. Gaat u akkoord, dan roept hij de tool opnieuw aan met het confirmation_token: de bestelling wordt geplaatst en afgeschreven.
3. Het token is 10 minuten geldig. Als intussen de winkelwagen, een prijs of de sleutel verandert, wordt het geweigerd (confirmation_expired) en herhaalt de agent stap 1. Opnieuw aanroepen met hetzelfde token na een onderbreking geeft dezelfde bestelling terug, zonder tweede afschrijving.

Zelfgeschreven client

De server is sessieloos: elk JSON-RPC-bericht gaat als POST en het antwoord komt als JSON. Stuur Accept: application/json, text/event-stream en Content-Type: application/json mee, anders antwoordt de server 406. GET en DELETE geven 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"}'

Auditeren en plannen

Een agent kan een site auditeren en op basis van het rapport links over meerdere maanden spreiden. Vier stappen, met de tools van de MCP-server.

1. run_audit start de volledige audit van een domein: technische controles, zichtbaarheid in ChatGPT en sites waar een link zou helpen. Reken op enkele minuten. Er wordt niets afgeschreven, en het rapport wordt ontgrendeld met het auditkrediet van de organisatie als ze dat heeft. Limiet: 10 audits per sleutel per 24 uur; vraagt u hetzelfde domein binnen een uur opnieuw aan, dan krijgt u de bestaande audit terug.
2. get_audit geeft de status en de huidige stap, daarna het rapport in summary zodra de status ready is. Roep het elke 30 tot 60 seconden aan. list_audits toont de audits van de organisatie, de nieuwste eerst.
3. plan_links maakt uit een klare audit een kalender: een maandbudget in euro excl. btw (minstens 100 €), 2 tot 12 maanden en optioneel een startdatum en de doelpagina's. Net als bij een aankoop zijn er twee stappen. Zonder token wordt niets opgeslagen: de agent krijgt de kalender (links, verzenddata, totaal) en een confirmation_token dat 10 minuten geldig is. Na uw akkoord roept hij de tool opnieuw aan met dezelfde velden en het token, en wordt het plan opgeslagen.
4. get_plan volgt elke link: doelpagina, ankertekst, prijs en status (ingepland, besteld, gepubliceerd, geannuleerd of mislukt, met de oorzaak van een mislukking, zoals insufficient_credits). cancel_planned_link annuleert een via de API geplande link, of alle nog niet bestelde links van een domein. Links die ons team heeft ingepland blijven staan: team_planned voor één link, skipped_team_planned voor hun aantal.

Bij het opslaan van het plan wordt niets afgeschreven. Elke link wordt op de dag van verzending in credits afgeschreven, tegen de prijs die die dag opnieuw is opgehaald, tijdens de dagelijkse ochtendronde (rond 06:20 UTC). Is het saldo die dag te laag, dan wordt de link niet besteld en staat hij in get_plan als mislukt. Een link die al besteld is, kan niet meer worden geannuleerd.

Rechten: run_audit en cancel_planned_link vragen cart, plan_links vraagt purchase, en get_audit, list_audits en get_plan vragen read. De bestedingslimieten van de sleutel gelden ook voor geplande links.

In het dashboard toont de pagina Delegatie deze links in het blok ‘Geplande links’. De eigenaar van de organisatie kan daar de via de API geplande links verwijderen. Links die ons team heeft gepland, zijn alleen-lezen.

Referentie

Elke route met het bijbehorende recht en de bijbehorende MCP-tool. Parameters, antwoordschema's en fouten per route: de OpenAPI 3.1-beschrijving.

Een vraag over de API? Schrijf ons, iemand van het team antwoordt u.