GetLinkFast API och MCP-server

Vad det är till för

• Byråer och SEO-team: koppla era interna verktyg och uppföljningspaneler till ditt konto. Katalog, varukorg, beställningar och statusar läses som JSON.
• AI-agenter: be Claude Code eller Cursor ”hitta 5 finanssajter med DR 40+ och beställ”. Agenten söker, visar dig sammanfattningen och beställer först när du godkänt.
• Make, n8n, Zapier: en HTTP-modul och en nyckel räcker.

API:t säljer gästartiklar (guest_post), länkinfogningar (link_insertion) och SEO/GEO-paket, endast mot saldo. Köp av saldo och övriga erbjudanden finns kvar i kontrollpanelen.

Skapa en nyckel

1. Öppna Kontrollpanel → API-åtkomst.
2. Namnge nyckeln (till exempel ”Claude-agent” eller ”Make-rapportering”) och välj dess behörigheter. På en nyckel som får beställa kan du sätta ett tak per beställning och ett tak över 24 timmar.
3. Kopiera nyckeln. Den börjar med glf_live_ och visas bara en gång: vi sparar bara ett avtryck av den.
4. Skicka den i huvudet på varje förfrågan: Authorization: Bearer glf_live_…

Högst 10 aktiva nycklar per organisation. En återkallad nyckel slutar fungera direkt, liksom nycklarna för en medlem som lämnar organisationen. Håll nyckeln utanför dina kodförråd: den som har den agerar i din organisations namn.

En nyckels behörigheter

Varje nyckel har en eller flera behörigheter. En förfrågan utan den behörighet som krävs får 403 insufficient_scope, och en AI-agent ser bara de tillåtna verktygen.

Snabbstart

Alla rutter börjar med https://www.getlinkfast.com/api/v1. Behåll www: adressen utan www omdirigerar, och en HTTP-klient skickar inte längre huvudet Authorization efter en omdirigering.

Beloppen är i euro exklusive moms. Svaren är JSON, med fält i 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"}'

Ersätt site_id med id:t för en sajt från steg 2. Skicka aldrig ett pris: servern räknar ut det.

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

Svaret ger beställningens id, det dragna beloppet och ditt återstående saldo. Följ sedan förloppet med GET /orders/{id}.

Beställa mot saldo

API:t beställer endast mot saldo och startar aldrig en kortbetalning. Saldot fylls på i kontrollpanelen.

En beställning tar raderna guest_post och link_insertion i varukorgen. Övriga rader, tillagda från kontrollpanelen, ligger kvar i varukorgen och listas i skipped_items.

Inget tak som standard: ditt saldo är den enda gränsen. På en nyckel som får beställa sätter du ett tak per beställning och ett tak över rullande 24 timmar. En beställning som överskrider dem nekas (403 spending_limit_exceeded, med vad som återstår), utan dragning.

Otillräckligt saldo: 402 insufficient_credits, med det saknade beloppet och länken till sidan Saldo, att skicka vidare till någon i ditt team. Inget dras.

Därefter fungerar allt som från kontrollpanelen: bekräftelsemejl och uppföljning på skärmen Beställningar, där beställningen bär namnet på nyckeln som lade den.

Huvudet Idempotency-Key

• Obligatoriskt på POST /checkout och POST /packs/orders: 8 till 128 utskrivbara ASCII-tecken, utan mellanslag. Utan det: 400 idempotency_key_required.
• Ett värde motsvarar en köpavsikt. Skickas samma värde igen returneras den ursprungliga beställningen (200, "replayed": true) utan en andra dragning, även om varukorgen har ändrats sedan dess.
• Efter en tidsgräns eller ett nätverksavbrott försöker du igen med samma värde: du betalar inte två gånger.
• För ett nytt köp genererar du ett nytt värde, till exempel ett UUID.
• På POST /checkout liksom på POST /packs/orders nekas ett värde som redan använts för ett annat köp: 409 idempotency_conflict, utan dragning. För ett paket nekas även samma värde skickat med annat innehåll.
• På MCP-sidan fyller bekräftelsetoken den rollen: du behöver inte generera något.

Gränser

• 120 förfrågningar per minut och nyckel för läsning, och lika många, separat, för varukorgen: det ena tär inte på det andra.
• 10 anrop per minut och nyckel till köprutterna eller köpverktygen — omförsök, avslag och MCP:s sammanfattningssteg inräknade.
• 300 HTTP-förfrågningar per minut och nyckel på MCP-servern. Varje anropat verktyg räknas dessutom mot gränsen för sin behörighet.
• Därutöver: 429 rate_limited. Väntetiden i sekunder anges av huvudet Retry-After över HTTP, och av details.retry_after_seconds i ett MCP-verktygsresultat.
• Högst 100 resultat per sida (page_size).
• Förfrågans brödtext: högst 1 MB.

Felkoder

Alla fel har samma form. Testa code: den är stabil. message är på engelska och riktar sig till utvecklaren; details anger det felaktiga fältet eller beloppen.

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

MCP-servern ger din AI-agent samma funktioner som API:t, med samma nyckel. Dess adress: https://www.getlinkfast.com/api/mcp.

Claude Code

Ett kommando i din terminal:

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

Cursor

I ~/.cursor/mcp.json. Undvik ett projekts fil .cursor/mcp.json: den hamnar ofta i kodförrådet, tillsammans med nyckeln.

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

Claude Desktop

Claude Desktop skickar inga egna huvuden till en fjärrserver och kan därför inte vidarebefordra din nyckel. Den kopplas in direkt via OAuth-anslutningen, som är planerad till en kommande version. Använd i dag Claude Code eller Cursor: de skickar nyckeln i huvudet Authorization.

Verktygen

Agenten ser bara de verktyg som nyckelns behörigheter tillåter: en nyckel utan rätt att beställa har inget köpverktyg.

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

Köp i två steg

1. Agenten anropar checkout eller order_pack utan confirmation_token: inget dras. Den får sammanfattningen (rader, summa, saldo efter dragning, återstående tak) och en confirmation_token.
2. Den visar dig sammanfattningen. Om du godkänner anropar den verktyget igen med confirmation_token: beställningen läggs och dras.
3. Token gäller i 10 minuter. Om varukorgen, ett pris eller nyckeln ändras under tiden nekas den (confirmation_expired) och agenten gör om steg 1. Ett nytt anrop med samma token efter ett avbrott returnerar samma beställning, utan en andra dragning.

Handskriven klient

Servern är sessionslös: varje JSON-RPC-meddelande skickas som POST och svaret kommer som JSON. Skicka Accept: application/json, text/event-stream och Content-Type: application/json, annars svarar servern 406. GET och DELETE svarar 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"}'

Granska och planera

En agent kan granska en webbplats och sedan sprida länkar över flera månader utifrån rapporten. Fyra steg, med verktygen i MCP-servern.

1. run_audit startar den fullständiga granskningen av en domän: tekniska kontroller, synlighet i ChatGPT och webbplatser där en länk skulle hjälpa. Räkna med några minuter. Inget dras, och rapporten låses upp med organisationens granskningskvot om den har en. Gräns: 10 granskningar per nyckel och 24 timmar; om samma domän begärs igen inom en timme returneras den befintliga granskningen.
2. get_audit ger status och aktuellt steg, därefter rapporten i summary när statusen blir ready. Anropa det var 30:e till 60:e sekund. list_audits listar organisationens granskningar, den nyaste först.
3. plan_links bygger en kalender utifrån en färdig granskning: en månadsbudget i euro exkl. moms (minst 100 €), 2 till 12 månader och som tillval ett startdatum och målsidor. Som vid ett köp är det två steg. Utan token sparas inget: agenten får kalendern (länkar, sändningsdatum, summa) och en confirmation_token som gäller i 10 minuter. Efter ditt godkännande anropar den verktyget igen med samma fält och token, och planen sparas.
4. get_plan följer varje länk: målsida, ankartext, pris och status (schemalagd, beställd, publicerad, avbokad eller misslyckad, med orsaken till ett misslyckande, till exempel insufficient_credits). cancel_planned_link avbokar en länk som planerats via API:t, eller alla ännu inte beställda länkar för en domän. Länkar som vårt team har schemalagt ligger kvar: team_planned för en länk, skipped_team_planned för antalet.

Inget dras när planen sparas. Varje länk dras i krediter på sändningsdagen, till priset som läses om den dagen, vid det dagliga morgonpasset (omkring 06:20 UTC). Räcker inte saldot den dagen beställs länken inte och visas som misslyckad i get_plan. En länk som redan är beställd kan inte längre avbrytas.

Behörigheter: run_audit och cancel_planned_link kräver cart, plan_links kräver purchase, och get_audit, list_audits och get_plan kräver read. Nyckelns utgiftstak gäller även planerade länkar.

I kontrollpanelen visar sidan Delegering dessa länkar i blocket ”Schemalagda länkar”. Organisationens ägare kan ta bort länkar som planerats via API:t där. Länkar som vårt team har planerat är skrivskyddade.

Referens

Varje rutt med sin behörighet och motsvarande MCP-verktyg. Parametrar, svarsscheman och fel rutt för rutt: OpenAPI 3.1-beskrivningen.

En fråga om API:t? Skriv till oss, så svarar en person i teamet.