Referentie
Backlinks online controleren: acties, kosten, parameters
Een eenvoudige referentie voor de calls die in casework worden gebruikt. Kosten zijn credits, en 1 credit is $0.0001. Elke call wordt één keer gefactureerd, ongeacht het aantal teruggegeven rijen.
Acties gegroepeerd op prijs
| Actie | Credits | Gebruik het om |
|---|---|---|
domain, overview, stats, suggest | Gratis, geen key | Eerste kennismaking met een domein, de rating en de kopcijfers |
bulk_dr | 1 | Beoordeel tot 2.000 domeinen in één call (GET domains= of een POST-body) |
compare | 1 | Zet tot 20 domeinen naast elkaar |
top, dr_distribution, tld_breakdown | 1 | Bekijk de vorm: koplopers, de verdeling van ratings, de mix van TLD's |
refdomains, backlinks | 2 | Lijst van verwijzende domeinen |
anchors, anchor_cloud, toppages | 2 | Lees de gebruikte woorden en de pagina's die links aantrekken |
intersect | 2 | Vind gedeelde verwijzende domeinen voor 2 tot 10 domeinen |
search | 3 | Volledige tekstzoekopdracht over anchors, titels en URL's |
keyword | 3 | Vind wie gelinkt is met een exacte anchor |
Vraag velden aan, één voor één
Zes parameters dekken bijna elke call die in casework wordt gebruikt. Elke vermelding zegt wat de parameter doet en waar deze stopt.
action
Noemt de call, zoals overview of intersect. Elke request vereist er één, en de actie bepaalt de prijs.
q
Het onderzochte domein, geschreven zonder protocol, voor single-domain acties zoals overview en refdomains.
domains
Een door komma's gescheiden lijst voor multi-domain acties. intersect vereist 2 tot 10 domeinen, compare tot 20, en bulk_dr tot 2.000 via GET of in een POST-body.
key
Je sk_ key, doorgegeven als parameter of als Authorization: Bearer header. De gratis acties werken zonder key.
page en per
page navigeert door de resultaten en per stelt het aantal rijen per pagina in, van 10 tot 5000. Diepe paginering stopt bij 50.000 rijen, dus verfijn de vraag voordat je zo ver gaat.
sort en order
sort noemt de kolom en order accepteert asc of desc. Referring domains sorteren op rating in oplopende volgorde zet de dunste links bovenaan, waar footprint-mogelijkheden zich vaak voordoen.
Parameters die je zult hergebruiken
Authenticatie is een key parameter of een Authorization: Bearer sk_... header. Houd keys buiten URL's die je in chat plakt, omdat query strings in logs terechtkomen. CORS is open, dus een browsertool werkt net zo goed als een script. Handig.
Paginering gebruikt page en per, waarbij per loopt van 10 tot 5000. Eenvoudig. Een enkele call retourneert tot 1.000 rijen, en diepe paginering is beperkt tot 50.000. Sortering gebruikt sort plus order=asc of order=desc.
Zet de goedkope tail eerst. Referring domains sorteren op rating in oplopende volgorde zet de dunne domeinen bovenaan, waar footprint-mogelijkheden zichtbaar worden. Dat ene gewoontje bespaart een uur.
Houd de parameters in dezelfde volgorde elke keer. Een vaste volgorde maakt het eenvoudig om twee opgeslagen adressen visueel te vergelijken en voorkomt dat een diff vol ruis loopt.
Begroet een call voordat je hem uitvoert
De prijs volgt de actie, niet het aantal rijen. Dat is de regel. Een refdomains call kost 2 credits, of hij nu een handvol rijen retourneert of een volledige pagina. Vermenigvuldig de prijs met het aantal calls dat je plant, niet met het aantal rijen dat je hoopt te zien.
Schrijf het plan voordat je de eerste call doet. Een korte lijst met acties, domeinen en verwachte calls is genoeg. Het verandert een verrassingsfactuur in een vraag. Beantwoord hem vroeg.
Per call, niet per rij
Elke call wordt één keer gefactureerd. Door een lange lijst heen pagineren is één charge per pagina die je aanvraagt, dus een hogere per waarde kan het aantal charges bij een lange pull verminderen. Lees _credits na de eerste pagina om de prijs te bevestigen voordat je doorgaat. Elke pagina van een gepagineerde pull is een aparte call, dus tel de pagina's voordat je begint en houd per op elke pagina hetzelfde.
Stel de kosten af tegen de beslissing
Weeg de prijs van een antwoord af tegen wat het antwoord zal veranderen. Een rating check die een aankoop kan beïnvloeden rechtvaardigt een betaalde pull. Een voorbijgaande nieuwsgierigheid naar een concurrent doet dat zelden. Houd de beslissing en de uitgegeven credits in dezelfde notitie.
Gratis calls als poort
Voer eerst domain, overview en stats uit. Ze kosten niets en tonen of een betaalde pull de moeite waard is. Stel je een domein voor waarvan de overview bijna geen verwijzende domeinen laat zien. Misschien heb je refdomains helemaal niet nodig, en kunnen de bespaarde credits naar een concurrent gaan. De network method gebruikt dezelfde poort.
Het saldo op de account
Het saldo staat in _credits op elke keyed call. Lees het na elke run en kopieer het cijfer naast het opgeslagen bestand. Een call die HTTP 402 retourneert betekent dat de credits op zijn, dus vul aan voordat je de volgende run doet.
Responses en fouten
| Wat je krijgt | Betekenis | Wat je moet doen |
|---|---|---|
ok in elke response | De vlag om te testen voordat je iets anders leest | Branch erop in je script |
_credits op keyed calls | Kosten van deze call en je resterende saldo | Log het naast het bewijsstuk |
| HTTP 401 | Key ontbreekt of is fout | Controleer de header of de key parameter |
| HTTP 402 | Credits zijn op | Vul aan met USDT (TRC-20) op de account pagina |
Hoe een voltooide pull eruitziet
Een voltooide pull voor het controleren van backlinks online is meer dan een JSON-bestand. Het bevat een datum, de call, het venster en een notitie van wat het niet kan tonen. Houd alle vier samen. Anders betekent het bestand elke maand minder.
De ruwe body
Sla de response precies op zoals deze terugkwam, voordat enige filtering of sortering. Een samenvatting die je zelf hebt geschreven, kan alleen worden gecontroleerd tegen het ruwe bestand, dus het ruwe bestand is het te bewaren bestand.
De parameters
Noteer de actie, het domein of de lijst, de pagineringwaarden en de sorteervolgorde. Twee pulls die alleen verschillen in per zijn niet vergelijkbaar totdat dat verschil is genoteerd.
Het venster
Geef de refresh-cyclus aan waaruit de cijfers komen, en de dag waarop je ze hebt opgehaald. Een cijfer zonder datum zal worden aangevochten met een frisser getal, en het argument draait dan om de datum in plaats van om de bevinding.
De limieten
Schrijf één regel over wat de call niet kon zien: links toegevoegd na de laatste refresh, pagina's geblokkeerd voor crawlers, links achter een login. De regel houdt een bevinding tegen het claimen van meer dan wat de data kan dragen.
Pagineren van een lange lijst zonder verspilling
Paginering is waar budgetten stil verdwijnen. Elke pagina is een andere call, en een lange lijst die pagina voor pagina wordt opgehaald, kan meer kosten dan de vraag waard was. Twee gewoontes houden het eerlijk.
Sorteer voordat je pagineert
Sorteer op welke kolom dan ook die je vraag beantwoordt, en ga dan door de resultaten heen. De eerste pagina zou de rijen moeten bevatten waarop je actie zou ondernemen. Als dat niet zo is, verander de sortering voordat je meer calls uitgeeft.
Stop zodra de vraag beantwoord is
Een lijst met tienduizenden rijen is zelden het antwoord. Stop met pagineren zodra de rijen die je nodig hebt op het scherm staan, sla die pagina op en noteer waar je stopt. De notitie vertelt de volgende lezer wat over het hoofd is gezien. Laat de rest ongelezen, tenzij de vraag verandert.
Fouten waar je direct op kunt reageren
Twee statuscodes verklaren de meeste gestopte runs. Elke heeft een oplossing die minder tijd kost dan raden naar de oorzaak.
HTTP 401 eerst, elke keer
Een 401 betekent dat de key ontbreekt of fout is, dus controleer de header of de parameter voordat je iets anders doet. Kopieer de key van de account pagina in plaats van hem opnieuw in te typen, omdat één verkeerd teken dezelfde fout oplevert. Als de gratis calls werken en de betaalde niet, is de key de waarschijnlijke oorzaak, omdat de gratis acties helemaal geen key nodig hebben.
HTTP 402 in het midden van een run
Een 402 stopt een run die een minuut geleden nog werkte. Stop de loop, lees het saldo en vul aan voordat je de volgende call doet. Probeer het niet opnieuw in een strakke loop, omdat elke retry een request is die niet kan slagen totdat het saldo verandert.
Voordat je een response vertrouwt
- Controleer of
okwaar is - Noteer de datum, omdat de index ongeveer maandelijks ververst wordt
- Onthoud dat DR round(100 · log(ref_domains + 1) / log(2·10^7)) is, geen getal van een derde partij
- Vergelijk verwijzende domeinen tussen tools, niet ruwe backlink totalen
- Archiveer het ruwe bestand, niet alleen je samenvatting
Limieten, duidelijk gesteld
Dit is linkdata tegen een lage prijs per call. Het volgt geen keywords. Het volgt ook geen rankings. Ahrefs en Semrush zijn uitgebreidere producten daarvoor, en Ahrefs verkoopt API-eenheden binnen abonnementen die beginnen bij $129 per maand voor 200.000 eenheden.
Recepten die deze calls gebruiken staan in casework met curl, en onbekende termen staan in het glossary.
Een response met wantrouwen lezen
Een response is een getuigenverklaring. Het is waar voor de index op de dag van de crawl, en stil over alles daarbuiten. Vraag je af wat de index niet had kunnen zien: pagina's geblokkeerd door robots.txt, links toegevoegd na de laatste refresh, links achter een login. Als je backlinks online wilt controleren zonder code te schrijven, roept de checker op de home page de gratis domain actie aan.
Controleer één ding elke keer handmatig. Kies een enkele verwijzende domein uit de lijst, open de pagina en zoek de link. Eenvoudig. Als het er is, vertrouw de rest een beetje meer. Zo niet, noteer de datum en de URL, en bekijk de troubleshooting table.
Laat een script nooit handelen op basis van één meting. Alarmeren is prima, maar links verwijderen, disavow-bestanden sturen of eigenaars e-mailen moet wachten op een mens.
