Dokumentation
Endpoint-referens och priser
En URL, många åtgärder. Detta är hela ytan.
SEOCheck forskningsgrupp ·

Åtgärder och kostnader
| Åtgärd | Krediter | Vad det returnerar |
|---|---|---|
| domain | gratis | Grundläggande post och DR för en domän |
| overview | gratis | Sammanfattning av en domäns länkprofil |
| stats | gratis | Indexbaserad statistik |
| suggest | gratis | Domänförslag medan du skriver |
| bulk_dr | 1 | DR för upp till 2 000 domäner |
| compare | 1 | Sida vid sida för upp till 20 domäner |
| top | 1 | Toppdomäner |
| dr_distribution | 1 | Fördelning av DR bland länkande domäner |
| tld_breakdown | 1 | Länkar per toppdomän |
| refdomains | 2 | Länkande domäner |
| backlinks | 2 | Individuella backlänkar |
| anchors | 2 | Ankertexter |
| toppages | 2 | Mest länkade sidor |
| anchor_cloud | 2 | Ankervikter |
| intersect | 2 | Delade länkskapare för 2 till 10 domäner |
| search | 3 | Fulltextsökning över ankertexter, titlar och URL:er |
| keyword | 3 | Vem som länkar med en exakt ankertext |
Autentisering och format
Bas-URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Föredrar du rubriker? Skicka Authorization: Bearer sk_... istället.
Detta API för backlänksanalys svarar med JSON och tillåter anrop över ursprungsgränser, så att en webbläsare kan anropa det direkt. Varje svar har ett ok-fält. Autentiserade svar innehåller också _credits, som anger kostnaden för det anropet och ditt återstående saldo.
Felmeddelandena är raka på sak. HTTP 401 betyder att nyckeln saknas eller är felaktig. HTTP 402 betyder att saldot är slut. Båda är lätta att hantera, och ingen bör försökas om igen i en loop.
För det första betalda anropet
- Kör
overviewpå en domän du känner till. Det är gratis. - Kontrollera att din nyckel fungerar med ett anrop på 1 kredit, t.ex.
compare. - Läs
_creditsi svaret och bekräfta att kostnaden stämmer med tabellen ovan. - Ställ in ett scriptlarm för HTTP 402 så att ett tomt saldo inte misslyckas i tystnad.
Paginering och sortering
Antalet rader per anrop kan vara upp till 1 000. Be om färre eller fler med per, från 10 till 5 000, navigera med page och sortera med sort och order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Parametrar som ändrar svaret
Varje åtgärd tar samma två grundläggande parametrar, action och q, och sedan en kort uppsättning alternativ. Läs dem först. De flesta misstag kommer från alternativ som ser valfria ut men som ändrar kostnaden eller radernas format. Läs alternativen innan du kopierar ett anrop från ett forum eller en blogg.
Exemplen nedan förutsätter en nyckel i parametern key. Ersätt platshållaren med din egen. Behåll nyckeln i en miljövariabel, inte i en fil du kollar in. Varje exempel i denna referens för API för backlänksanalys använder samma bas-URL.
Paginering med page och per
Alternativet per anger hur många rader som returneras, från 10 upp till 5 000. Alternativet page flyttar dig genom mängden. Ett anrop som ber om 500 rader och sedan page 2 returnerar nästa block, inte nästa drag av samma rader.
Djup paginering slutar vid 50 000 rader. Om ett jobb behöver mer än så, begränsa frågan med sort eller dela upp arbetet per domän, så att varje anrop förblir inom gränsen.
Sortering med sort och order
Sortera på servern, inte i ditt script. Att be om sort=dr&order=desc returnerar de starkaste länkande domänerna först, så att de rader du bryr dig om visas på första sidan. Att filtrera efter en fullständig nedladdning slösar både tid och krediter.
Använd order=asc när du vill ha de svagaste raderna, t.ex. för att hitta länkar som är tunna eller för att upptäcka ett plötsligt fall i en profil.
Listor: bulk_dr, compare och intersect
Liståtgärderna tar flera domäner i ett anrop. bulk_dr accepterar upp till 2 000 domäner för en kredit, med en GET-frågestring eller en POST-body. compare tar upp till 20 domäner, och intersect tar två till tio.
Eftersom priset inte beror på antalet rader är en lång lista i ett anrop billigare än många korta anrop. Säg att du kontrollerar 1 500 potentiella webbplatser på måndag. Det är ett anrop, inte 1 500.
Sök- och keyword-anrop kostar mer
Åtgärden search kör fulltextsökning över ankertexter, titlar och URL:er. Åtgärden keyword frågar vem som länkar med en exakt ankertext. Båda kostar tre krediter per anrop, så använd dem för att svara på en specifik fråga snarare än för att surfa.
Att välja per och page för ett första drag
För en första titt på en ny domän, börja med ett litet per, t.ex. 50. Du ser då formatet på raderna, fältnamnen och kostnaden i ett kort svar. Öka per först när du vet att raderna är vad du behöver. Samma vana fungerar för varje åtgärd i tabellen ovan.
Ett vanligt misstag är att begära 5 000 rader vid första försöket och sedan kasta de flesta av dem. Svaret blir större, väntan blir längre och den besparing du hoppades på syns inte.
Att läsa kreditmätaren
Varje autentiserat svar avslutas med _credits, vilket anger kostnaden för det anropet och ditt saldo efteråt. Logga det. Summera det i slutet av månaden så vet du din faktiska kostnad till en öre.
En grov budget hjälper. En tusen refdomains-anrop kostar 2 000 krediter, vilket är $0,20. En tusen search-anrop kostar 3 000 krediter, eller $0,30. Ett dagligt bulk_dr-körning på en lista med 2 000 domäner kostar 1 kredit, så cirka $0,003 per månad.
Jämfört med planer som börjar på $129 per månad för 200 000 API-enheter, som Ahrefs listar dem, är fakturans form annorlunda. Se jämförelsen för hur.

Att läsa fel och fältet _credits
Ett svar kan misslyckas på två olika sätt, och din kod bör hantera dem olika. Det är olika problem. En dålig nyckel är ett konfigurationsproblem. Ett tomt saldo är ett faktureringsproblem. Att hantera båda som ett generiskt fel döljer vilken fix du behöver.
Läs fältet ok först. Läs sedan blocket _credits. Bara efter det bör du titta på raderna, eftersom ett saknat eller kort resultat är lättare att förklara när du redan vet vad anropet kostade.
Hantera 401 och 402 separat
HTTP 401 betyder att nyckeln saknas eller är felaktig. Stoppa jobbet och fixa nyckeln. HTTP 402 betyder att saldot är slut. Ladda upp från kontosidan och fortsätt. Att försöka om ett 401 hjälper aldrig, och att försöka om ett 402 utan att ladda upp hjälper heller inte.
Logga saldot före och efter en körning
Skriv ner _credits-saldo i början av en körning och i slutet. Skillnaden bör matcha vad du förväntade dig från de anrop du gjorde. En större ökning betyder att en loop kördes oftare än du menade.
För en snabb kontroll, multiplicera antalet anrop med deras kreditkostnad. Om svaret är 40 och saldet sjönk med 4 000 är något fel med scriptet, inte med prislistan.
Kontrollera raderna du bad om
Ett lyckat svar med färre rader än förväntat är inte automatiskt ett fel. En liten domän kan helt enkelt ha få länkar. Jämför antalet rader med per-värdet du skickade, och behandla ett gap som en fråga att svara på, inte ett fel att dölja.
Testa de billiga anropen först
Innan du kopplar ett anrop till ett jobb, kör det en gång manuellt med de minsta rimliga alternativen. Kontrollera svaret, fältnamnen och _credits-värdet. Ett jobb som bryts på den andra raden är mycket svårare att felsöka än ett anrop som misslyckades vid första försöket.
En första session med API:et
Fyra anrop, i ordning, så att varje senare anrop är ett du redan förstår. Endast det första är kostnadsfritt, och det är avsiktligt.
Kör overview på en domän du känner till
Det är gratis och behöver ingen nyckel. Jämför sammanfattningen med vad du ser i search console och på webbplatsen själv, så att du vet hur ett normalt svar ser ut.
Testa nyckeln med ett anrop på 1 kredit
Skicka compare med din domän och en konkurrent. Bekräfta att ok-fältet är sant och att _credits visar en kostnad på en kredit.
Hämta en lista på 2 krediter med ett litet per
Be om refdomains med per=50 och sort=dr. Kontrollera att antalet rader och kreditkostnaden stämmer med tabellen ovan.
Skriv kostnaden i din logg
Registrera saldot före och efter. Från och med nu börjar varje script du skriver med den vanan, och en överraskande faktura blir en rad i en logg istället för ett mysterium.
Prissättning
Förbetald kredit. En kredit är $0,0001. Det finns inget abonnemang och inget månatligt minimum.
Gratisåtgärder
$0
- domain, overview, stats, suggest
- Ingen nyckel behövs
- Driver webbkontrollern
Betala per användning
$0.10per 1 000 anrop med en kredit
- $100 gratis kredit vid registrering
- Inget kort behövs
- Ladda upp med USDT (TRC-20)
- Faktureras en gång per anrop, inte per rad
Gränser du bör känna till
Indexet täcker 181 132 097 domäner och 2 774 625 913 domänlänkar. Det uppdateras ungefär en gång i månaden. Det är långsammare än en daglig crawl.
Djup paginering slutar vid 50 000 rader. För större drag, begränsa frågan med sort eller dela upp per domän.
Inloggning är endast via Google, och påfyllningar är i USDT. Börja med DR-checkern, testa en konkurrentrevision med konkurrentguiden, eller läs varför vissa team hoppar av Ahrefs API för ren länkverksamhet.
Vanliga frågor
Betalar jag per rad?
Nej. Ett anrop faktureras en gång, oavsett om det returnerar 10 rader eller 1 000.
Vad händer när krediterna tar slut?
API:et returnerar HTTP 402. Ladda upp med USDT (TRC-20) från kontosidan och fortsätt.
Var hittar jag min nyckel?
I dashboarden efter inloggning med Google.