Referentie
Ahrefs-backlinkrapport versus API-uitvoer: een referentie van acties
Als je gewend bent om een Ahrefs-backlinkrapport te exporteren, toont deze referentie welke onderdelen je kunt herbouwen vanuit onze acties, wat elke aanroep kost en waar de grote suites vooruitlopen.
Acties, prijzen en wat ze vervangen in een rapport
| Actie | Kredieten | Dichtstbijzijnde onderdeel van een typisch rapport | Opmerkingen |
|---|---|---|---|
| domein, overzicht, statistieken, suggestie | 0 | Aantallen koppen | Geen sleutel nodig |
| bulk_dr | 1 | Een DR-kolom voor een lijst | Maximaal 2.000 domeinen per aanroep |
| vergelijken | 1 | Domeinen naast elkaar | Maximaal 20 domeinen |
| top, dr_verdeling, tld_verdeling | 1 | Samenvattende grafieken | Samenvattingen in distributiestijl |
| verwijzendedomeinen | 2 | Tabblad Verwijzende domeinen | Gepagineerd |
| backlinks | 2 | Tabblad Backlinks | Gepagineerd |
| ankerteksten, ankerwolk | 2 | Tabblad Ankerteksten | Wolk is voor weergave |
| toppagina's | 2 | Beste op basis van links | Pagina's die links aantrekken |
| doorsnede | 2 | Linkdoorsnede | 2 tot 10 domeinen |
| zoekopdracht, trefwoord | 3 | Geen directe overeenkomst | Zoeken op anker, titel en URL |
Hoe de rapporttabbladen overeenkomen met onze acties
De meeste rapportexporten bestaan uit tabbladen, en elk tabblad heeft een ruwe equivalent hier. Geen exacte kopie. Lees de mapping als startpunt, omdat een veld dat in het ene tabblad bestaat, helemaal niet in onze respons hoeft te voorkomen.
Het tabblad Verwijzende domeinen
Stel je een rapport voor dat opent op verwijzende domeinen, gesorteerd op DR. Onze dichtstbijzijnde aanroep is refdomains, voor 2 kredieten, en deze kan op dezelfde manier worden gesorteerd. Verwacht dat je een of twee kolommen moet hernoemen in je script, omdat de veldnamen in rijen per actie verschillen.
Los de sortering tussen maanden op. Een lijst die de ene maand is gesorteerd op DR en de andere maand op verkeer, kan niet eerlijk worden gediffd, dus schrijf de sortersleutel in de bestandsnaam.
Het tabblad Ankerteksten, en waarom de wolk voor weergave is
anchors is de aanroep voor het anker-tabblad, voor 2 kredieten. anchor_cloud kost hetzelfde, maar zoals de tabel hierboven aangeeft, is het bedoeld voor weergave. Als een beslissing afhangt van cijfers, lees de gewone lijst.
Lees ankerteksten met één vraag: zou een echte schrijver deze woorden typen? Bedrijfsnamen en kale URL's slagen meestal. Een blok identieke geldzinnen dat zich over veel domeinen herhaalt, niet, en dat blok is het eerste om te controleren.
Toppagina's en het twee-tot-tien domeinoverzicht
toppages is het dichtstbijzijnde ding bij een tabblad 'beste op basis van links'. Het toont welke pagina's links aantrekken, en dat zegt vaak meer dan een domeintotaal wanneer een rangschikkingsverandering één map van de site raakt.
intersect neemt tussen twee en tien domeinen in beslag en kost 2 kredieten per aanroep. Stel dat je je site vergelijkt met twee concurrenten. De overlap toont dan welke linkende domeinen jullie drieën delen, wat eenvoudig en goedkoop is.
Parameters die gelden voor alle aanroepen
Drie dingen sturen elke lijst. Dit zijn page, per en de paar sort met order. Houd ze constant tussen maanden.
per accepteert 10 tot 5000, hoewel één aanroep maximaal 1.000 rijen retourneert, en diepe paginering stopt bij 50.000 rijen. Elke aanroep wordt één keer gefactureerd, ongeacht het aantal rijen, dus het vragen om een volledige pagina kost hetzelfde als het vragen om tien rijen.
Authenticatie vereist ofwel key=sk_... in de query of een Authorization: Bearer sk_...-header. CORS is open, maar houd de sleutel op je server, omdat browsercode deze aan elke bezoeker blootstelt.
Volgorde doet ertoe. Wanneer je door resultaten pagina's doorloopt, sorteer dan op aflopende DR voor domeinen die waarschijnlijk belangrijk zijn, of oplopend om de lange staart van kleine sites te inspecteren. Wat je ook kiest, schrijf het op naast het bestand.
Behandel de tabel hierboven als een kaart en de opgeslagen responsen als het terrein. Als een veld dat je verwachtte afwezig is, bouw dan rond wat er wel is.
Een maandelijkse export, in vijf stappen
Voer elke maand dezelfde vijf stappen uit, zodat de opgeslagen bestanden op één lijn liggen wanneer je ze vergelijkt.
- 1
Kies de aanroepen
Kies
refdomains,anchorsentoppagesvoor elk domein. Overzicht en statistieken zijn gratis, dus voeg ze toe aan dezelfde map. - 2
Stel de diepte vast
Stel
page,per,sortenorderéén keer in en houd ze vast. Per kan tot 5000 gaan, maar één enkele aanroep retourneert maximaal 1.000 rijen. - 3
Sla elke respons ongewijzigd op
Schrijf de ruwe JSON naar schijf voordat je begint met parseren. Als een script later faalt, is de opgeslagen kopie wat je opnieuw uitvoert.
- 4
Lees het _credits-object
Elke geauthenticeerde respons rapporteert de kosten en het resterende saldo. Kopieer beide naar een logregel, zodat de maandelijkse uitgaven zichtbaar zijn zonder dashboard.
- 5
Vergelijk met vorige maand
Diff de opgeslagen kopieën. Het diff-recept somt de drie kolommen op die de moeite waard zijn om te behouden.
Kredieten, rijlimieten en een maandelijkse rekening
De prijslijst is kort. De rekening hangt af van hoe vaak je aanroept en hoe je pagina's doorloopt. Drie gewoontes bepalen het meeste.
Eén charge per aanroep, ongeacht het aantal rijen
Elke aanroep wordt één keer gefactureerd, dus per=1000 kost hetzelfde als per=10 voor dezelfde actie. Een volledige pagina is de goedkope keuze voor een lijst die je zult hergebruiken, en een verspillende keuze voor een snelle blik.
Stel dat je refdomains voor één domein ophaalt op dezelfde dag elke maand. Dat zijn 2 kredieten, of $0.0002, per maand tegen het gepubliceerde tarief van $0.0001 per krediet.
De plafond van 50.000 rijen
Diepe paginering stopt bij 50.000 rijen. Een lus die blijft vragen om de volgende pagina daarna, krijgt niets nieuws, dus beperk het aantal pagina's voordat de lus begint.
Het bereiken van het plafond bij 1.000 rijen per aanroep vereist vijftig aanroepen. Bij 2 kredieten per aanroep zijn dat 100 kredieten, of $0.01. Goedkoop, maar alleen als het script stopt wanneer het moet.
Een klein budget voor een maandelijkse gewoonte
Stel je tien domeinen voor, elk met refdomains en anchors één keer per maand opgehaald. Dat zijn 40 kredieten per maand, of $0.004, afgeschreven van de $100 gratis krediet bij aanmelding, wat 1.000.000 kredieten is.
In dat tempo houdt het gratis krediet het lang vol, en de uitgavenlog toont of het tempo standhoudt. Houd het vast.
Probleemoplossen voor responsen
| Je ziet | Oorzaak | Oplossing |
|---|---|---|
| HTTP 401 | Sleutel ontbreekt of is onjuist | Controleer de sleutel en de spelling van de header |
| HTTP 402 | Krediet is opgebruikt | Laad op in USDT (TRC-20) op de accountpagina |
| ok is false | Het verzoek werd afgewezen | Lees de boodschap in de body en de parameters die je hebt verzonden |
| Minder rijen dan een grote suite toont | Andere index en kruistijdstippen | Vergelijk trends, geen totalen |
| Een link die je vorige week maakte, ontbreekt | Index ongeveer maandelijks herbouwd | Controleer opnieuw in de volgende cyclus |
Een ontbrekende rij is een vraag, geen antwoord
Een rij die tussen twee responsen verdwijnt, is een veelvoorkomende verrassing. Voordat je beslist wat het betekent, scheid de verhalen die het kan vertellen.
Drie verhalen achter één ontbrekende rij
De link is misschien nooit geïndexeerd, of hij is verwijderd. Het derde verhaal is timing: de pagina is gekruist vóór of na een indexherbouwing, en de rij verschijnt in een latere cyclus.
Eén aanroep kan deze niet scheiden. Alleen een tweede kopie die later is genomen, plus een blik op de pagina zelf, beperkt de lijst.
Weeg de rij voordat je hem achtervolgt
Controleer het DR van het domein en de linkende pagina voordat je outreach doet. Een verwijderde link van een zwakke site verandert zelden een plan. Een verwijderde link van een pagina die lezers trok, verdient misschien een opmerking aan de eigenaar. De verdachte tabel toont waar een ontbrekende rij staat binnen de bredere oorzaken.
Een export verplaatsen naar onze aanroepen
Kan ik dezelfde kolommen exporteren die Ahrefs geeft?
Niet één-op-één. Rijvelden variëren per actie, dus open een opgeslagen respons en koppel de namen zelf. De tabel hierboven noemt de dichtstbijzijnde actie voor elk onderdeel van een rapport, maar de veldnamen zullen verschillen.
Is de API goedkoper dan een Ahrefs-abonnement?
Het antwoord hangt af van het aantal aanroepen. Onze gepubliceerde prijs is $0.10 per 1.000 een-krediet aanroepen. Ahrefs verkoopt API-eenheden binnen abonnementen, vanaf $129 per maand voor 200.000 eenheden, met minimaal 50 eenheden per verzoek. Tel je aanroepen voordat je besluit.
Zullen oude exporten nog wel met nieuwe kunnen worden vergeleken?
Alleen als de sortering, de diepte en de bron overeenkomen. Een bestand dat een andere week uit een ander hulpmiddel is opgehaald, is een andere steekproef. Bewaar de oude bestanden en begin de nieuwe serie met een duidelijk gelabeld paar.
Moet ik de sleutel op mijn server houden?
Ja. CORS is open, dus een browser kan de API aanroepen, maar een sleutel in front-end-code is zichtbaar voor elke bezoeker. Stuur verzoeken vanaf je server en lees de sleutel uit een omgevingsvariabele.
Voordat je een rapport bouwt bovenop deze aanroepen
- Open één opgeslagen respons per actie en noteer de rijveldnamen die je daadwerkelijk ontvangt.
- Bepaal welk maandlabel in elke bestandsnaam komt.
- Houd
page,per,sortenorderidentiek tussen maandelijkse ophalingen. - Log het
_credits-object van elke geauthenticeerde respons zodat de uitgaven per taak zichtbaar zijn. - Beperk diepe paginering in je script, omdat lijsten stoppen bij 50.000 rijen.
- Voeg een versheidsnotitie toe aan elk rapport dat je overhandigt, met de mededeling dat de index ongeveer maandelijks wordt ververst.
De envelop lezen
Elke respons bevat ok. Geauthenticeerde responsen voegen ook _credits toe, zodat je de uitgaven per taak kunt loggen en het saldo kunt bewaken.
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"Ahrefs verkoopt API-eenheden binnen abonnementen, vanaf $129 per maand voor 200.000 eenheden met een minimum van 50 eenheden per verzoek. Het biedt ook trefwoorden, ranktracking en een frissere crawl, en dat doet Semrush ook. Wij dekken linkgegevens tegen een lage prijs per aanroep en niets daarbuiten. Gebruik het maandelijkse runbook als dat de kloof is die je moet dichten. De spam-spike beslissingsboom is een goed eerste gebruik van de goedkope samenvattingsaanroepen.
