Naar de inhoud springen
SEOCheck
SEOCheckAanmelden

Documentatie

Endpoint-referentie en prijzen

Eén URL, veel acties. Dit is het volledige overzicht.

SEOCheck research team ·

Een stevige stenen brug die een mistige vallei overspant, symboliserend voor een betrouwbaar API-eindpunt

Acties en kosten

ActieCreditsWat het retourneert
domeingratisBasisrecord en DR voor één domein
overzichtgratisSamenvatting van het linkprofiel van een domein
statistiekengratisIndexbrede statistieken
suggererengratisDomeinsuggesties tijdens het typen
bulk_dr1DR voor maximaal 2.000 domeinen
vergelijken1Naast elkaar voor maximaal 20 domeinen
top1Topdomeinen
dr_verdeling1Verspreiding van DR onder linkende domeinen
tld_verdeling1Links per top-level domein
verwijzingsdomeinen2Verwijzingsdomeinen
backlinks2Individuele backlinks
anchor teksten2Anchorteksten
doelpagina's2Meest gelinkte pagina's
anchor_wolk2Anchor gewichten
snijpunt2Gedeelde linkers voor 2 tot 10 domeinen
zoeken3Volledige tekstzoekopdracht over anchors, titels en URL's
trefwoord3Wie wordt gelinkt met een exacte anchor

Autoriteit en vorm

Basis-URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Liever headers? Stuur Authorization: Bearer sk_... in plaats daarvan.

Deze backlinkanalyse-API antwoordt in JSON en staat cross-origin-aanroepen toe, zodat een browser deze direct kan aanroepen. Elk antwoord bevat een ok-veld. Geauthenticeerde antwoorden bevatten ook _credits, dat de kosten van die aanroep en je resterende saldo bevat.

Fouten zijn rechttoe rechtaan. HTTP 401 betekent dat de sleutel ontbreekt of fout is. HTTP 402 betekent dat het saldo op is. Beide zijn eenvoudig af te handelen en mogen niet in een lus worden herhaald.

Voor de eerste betaalde aanroep

  • Voer overview uit op een domein dat je kent. Dit is gratis.
  • Controleer of je sleutel werkt met één aanroep van 1 credit, zoals compare.
  • Lees _credits in het antwoord en bevestig dat de kosten overeenkomen met de tabel hierboven.
  • Stel een scriptwaarschuwing in voor HTTP 402, zodat een leeg saldo niet stil faalt.

Paginering en sortering

Het aantal rijen per aanroep loopt op tot 1.000. Vraag minder of meer aan met per, van 10 tot 5000, blader met page en sorteer met sort en order.

bash
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'
Een tuinder die zorgvuldig een bonsaiboom snoeit met gespecialiseerde scharen, illustrerend voor precieze aanpassingen

Parameters die het antwoord beïnvloeden

Elke actie vereist dezelfde twee basisparameters, action en q, en daarna een korte reeks opties. Lees ze eerst. De meeste fouten ontstaan door opties die optionaal lijken, maar wel de kosten of de vorm van de rijen beïnvloeden. Lees de opties voordat je een aanroep uit een forum of blog kopieert.

De onderstaande voorbeelden gaan uit van een sleutel in de parameter key. Vervang de placeholder door je eigen sleutel. Bewaar de sleutel in een omgevingsvariabele, niet in een bestand dat je committet. Elk voorbeeld in deze backlinkanalyse-API-referentie gebruikt dezelfde basis-URL.

Paginering met page en per

De optie per bepaalt hoeveel rijen worden teruggegeven, van 10 tot 5000. Met de optie page blader je door de set. Een aanroep die 500 rijen vraagt en vervolgens page 2, retourneert de volgende blok, niet de volgende set van dezelfde rijen.

Diepe paginering stopt bij 50.000 rijen. Als een taak meer dan dat vereist, verfijn dan de query met sort of verdeel het werk per domein, zodat elke aanroep binnen de limiet blijft.

Sorteren met sort en order

Sorteer op de server, niet in je script. Een verzoek met sort=dr&order=desc geeft de sterkste verwijzende domeinen eerst, zodat de rijen die voor jou relevant zijn op de eerste pagina verschijnen. Filteren na het downloaden van alle data kost zowel tijd als credits.

Gebruik order=asc als je de zwakste rijen wilt, bijvoorbeeld om links te vinden die dun zijn of om een plotseling verlies in een profiel te signaleren.

Lijsten: bulk_dr, compare en intersect

De lijstacties verwerken meerdere domeinen in één call. bulk_dr accepteert maximaal 2.000 domeinen voor één credit, via een GET-querystring of een POST-body. compare accepteert maximaal 20 domeinen en intersect accepteert twee tot tien.

Omdat de prijs niet afhankelijk is van het aantal rijen, is een lange lijst in één call goedkoper dan vele korte calls. Stel dat je maandag 1.500 prospect-sites controleert. Dat is één call, geen 1.500.

Zoek- en keyword-calls kosten meer

De search-actie voert een volledige tekstzoekopdracht uit over anchors, titels en URLs. De keyword-actie vraagt wie er gelinkt is met een exacte anchor. Beide kosten drie credits per call, dus gebruik ze om een specifieke vraag te beantwoorden in plaats van om te browsen.

Kiezen voor per en page voor een eerste pull

Voor een eerste blik op een nieuw domein, begin met een kleine per, zoals 50. Je ziet zo de vorm van de rijen, de veldnamen en de kosten in één kort antwoord. Verhoog per pas als je weet dat de rijen zijn wat je nodig hebt. Dezelfde gewoonte werkt voor elke actie in de tabel hierboven.

Een veelgemaakte fout is om 5.000 rijen in één keer aan te vragen en daarna het grootste deel ervan af te wijzen. Het antwoord is groter, de wachttijd is langer en de besparing die je hoopte te behalen, blijft uit.

De creditmeter aflezen

Elk geauthenticeerd antwoord eindigt met _credits, wat de kosten van die call en je saldo daarna geeft. Log dit. Tel het aan het einde van de maand op en je weet je werkelijke rekening tot op de cent.

Een ruwe begroting helpt. Duizend refdomains-calls kosten 2.000 credits, wat $0,20 is. Duizend search-calls kosten 3.000 credits, oftewel $0,30. Een dagelijkse bulk_dr-run op een lijst met 2.000 domeinen kost 1 credit, dus ongeveer $0,003 per maand.

Vergeleken met abonnementen die beginnen bij $129 per maand voor 200.000 API-eenheden, zoals Ahrefs ze aanbiedt, is de structuur van de rekening anders. Zie de vergelijking voor de details.

Een paar vintage messing weegschalen die twee verschillende gewichten balanceren, symboliserend voor verschillende fouttypen

Fouten en het _credits-veld lezen

Een antwoord kan op twee verschillende manieren falen, en je code moet deze verschillend behandelen. Het zijn twee verschillende problemen. Een verkeerde key is een configuratieprobleem. Een leeg saldo is een betalingsprobleem. Beide als één generieke fout afhandelen, verbergt welke oplossing je nodig hebt.

Lees eerst het ok-veld. Lees dan het _credits-blok. Pas daarna moet je naar de rijen kijken, omdat een ontbrekend of kort resultaat makkelijker uit te leggen is als je al weet wat de call kostte.

401 en 402 apart afhandelen

HTTP 401 betekent dat de key ontbreekt of verkeerd is. Stop de taak en los de key op. HTTP 402 betekent dat het saldo op is. Laad op via de accountpagina en ga verder. Een 401 opnieuw proberen helpt niet, en een 402 opnieuw proberen zonder opladen helpt ook niet.

Log het saldo voor en na een run

Schrijf het _credits-saldo aan het begin van een run en aan het einde op. Het verschil moet overeenkomen met wat je verwachtte op basis van de calls die je hebt gedaan. Een grotere sprong betekent dat een loop vaker is uitgevoerd dan de bedoeling was.

Voor een snelle controle vermenigvuldig je het aantal calls met hun creditkosten. Als het antwoord 40 is en het saldo daalde met 4.000, dan klopt er iets niet met het script, niet met de prijslijst.

De rijen controleren die je hebt aangevraagd

Een succesvol antwoord met minder rijen dan verwacht is niet automatisch een fout. Een klein domein heeft misschien gewoon weinig links. Vergelijk het aantal rijen met de per-waarde die je hebt verzonden en behandel een verschil als een vraag om te beantwoorden, niet als een fout om te verbergen.

Test eerst de goedkope calls

Voordat je een call in een taak opneemt, voer hem dan een keer handmatig uit met de kleinst mogelijke opties. Controleer het antwoord, de veldnamen en de _credits-waarde. Een taak die vastloopt op de tweede rij is veel lastiger te debuggen dan een call die faalde bij de eerste poging.

Een eerste sessie met de API

Vier calls, in volgorde, zodat elke volgende call er een is die je al begrijpt. Alleen de eerste is gratis, en dat is opzettelijk.

01

Overzicht uitvoeren op een domein dat je kent

Het is gratis en vereist geen key. Vergelijk de samenvatting met wat je ziet in de search console en op de site zelf, zodat je weet hoe een normaal antwoord eruitziet.

02

Test de key met één 1-credit call

Verstuur compare met jouw domein en één concurrent. Bevestig dat het ok-veld true is en dat _credits een kosten van één credit aangeeft.

03

Haal een 2-credit lijst op met een kleine per

Vraag om refdomains met per=50 en sort=dr. Controleer of het aantal rijen en de creditkosten overeenkomen met de tabel hierboven.

04

Schrijf de kosten in je logboek

Noteer het saldo voor en na. Vanaf nu begint elk script dat je schrijft met deze gewoonte, en een verrassende rekening wordt een regel in een logboek in plaats van een mysterie.

Prijzen

Prepaid credit. Één credit is $0,0001. Er is geen abonnement en geen maandelijks minimum.

Gratis acties

$0

  • domain, overview, stats, suggest
  • Geen key nodig
  • Aangedreven door de webchecker
Open de checker

Pay as you go

$0.10per 1.000 een-credit calls

  • $100 gratis credit bij aanmelding
  • Geen kaart nodig
  • Laad op met USDT (TRC-20)
  • Eén keer gefactureerd per call, niet per rij
Haal $100 gratis

Limieten die je moet kennen

De index dekt 181.132.097 domeinen en 2.774.625.913 domeinlinks. Hij wordt ongeveer maandelijks ververst. Dat is langzamer dan een dagelijkse crawl.

Diepe paginatie stopt bij 50.000 rijen. Voor grotere pulls, verfijn de query met sort of split op domein.

Inloggen kan alleen via Google, en opladen gebeurt in USDT. Begin met de DR checker, probeer een concurrentie-audit met de competitor guide, of lees waarom sommige teams de Ahrefs API verlaten voor pure linkwerk.

FAQ

Betaal ik per rij?

Nee. Een call wordt één keer gefactureerd, of hij nu 10 rijen of 1.000 teruggeeft.

Wat gebeurt er als de credits op zijn?

De API retourneert HTTP 402. Laad op met USDT (TRC-20) vanaf de accountpagina en ga verder.

Waar vind ik mijn key?

In het dashboard na inloggen met Google.