Referens
Ahrefs backlänkrapport mot API-utdata: en referens över åtgärder
Om du är van vid att exportera en Ahrefs-backlänkrapport visar denna referens vilka delar du kan bygga om från våra åtgärder, vad varje anrop kostar och var de stora paketen ligger före.
Åtgärder, priser och vad de ersätter i en rapport
| Åtgärd | Krediter | Närmaste delen av en typisk rapport | Noteringar |
|---|---|---|---|
| domain, overview, stats, suggest | 0 | Räknar rubriker | Ingen nyckel behövs |
| bulk_dr | 1 | En DR-kolumn för en lista | Upp till 2 000 domäner per anrop |
| compare | 1 | Domäner sida vid sida | Upp till 20 domäner |
| top, dr_distribution, tld_breakdown | 1 | Sammanfattningsdiagram | Sammanfattningar i distributionsformat |
| refdomains | 2 | Fliken för hänvisande domäner | Sidbaserad |
| backlinks | 2 | Fliken för backlänkar | Sidbaserad |
| anchors, anchor_cloud | 2 | Fliken för ankartexter | Svärmen är för visning |
| toppages | 2 | Bäst efter länkar | Sidor som attraherar länkar |
| intersect | 2 | Länkintersektion | 2 till 10 domäner |
| search, keyword | 3 | Ingen direkt matchning | Sökning efter ankartext, titel och URL |
Hur rapportflikarna mappas mot våra åtgärder
De flesta rapportexporter kommer i flikar, och varje flik har en ungefärlig motsvarighet här. Inte en exakt kopia. Läs mappningen som en utgångspunkt, eftersom ett fält som finns i en flik kanske inte finns i vårt svar alls.
Fliken för hänvisande domäner
Tänk dig en rapport som öppnas på hänvisande domäner sorterade efter DR. Vår närmaste motsvarighet är refdomains, till 2 krediter, och den kan sorteras på samma sätt. Räkna med att döpa om en eller två kolumner i ditt skript, eftersom radfältnamnen skiljer sig åt beroende på åtgärd.
Fixa sorteringen mellan månader. En lista sorterad efter DR en månad och efter trafik nästa månad kan inte jämföras ärligt, så skriv sortnyckeln i filnamnet.
Fliken för ankartexter, och varför svärmen är för visning
anchors är anropet för ankartextfliken, till 2 krediter. anchor_cloud kostar samma sak, men som tabellen ovan säger är den avsedd för visning. Om ett beslut beror på siffror, läs den vanliga listan.
Läs ankartexter med en fråga: skulle en riktig författare skriva dessa ord? Varumärkesnamn och blotta URL:er klarar vanligtvis testet. En block av identiska penningfraser upprepade över många domäner gör det inte, och det blocket är den del du ska kontrollera först.
Topp sidor och vyn för två till tio domäner
toppages är det närmaste till en flik för bäst efter länkar. Den visar vilka sidor som attraherar länkar, och det säger ofta mer än ett domäntotal när en rangförändring drabbar en mapp på webbplatsen.
intersect tar mellan två och tio domäner och kostar 2 krediter per anrop. Säg att du jämför din webbplats med två konkurrenter. Överlappningen visar då vilka länkande webbplatser de tre av er delar, vilket är enkelt och billigt.
Parametrar som gäller för alla anrop
Tre saker styr varje lista. De är page, per och paret sort med order. Håll dem fixerade mellan månader.
per accepterar 10 till 5000, även om ett anrop returnerar upp till 1 000 rader, och djup sidbaserad paginering slutar vid 50 000 rader. Varje anrop debiteras en gång oavsett antal rader, så att fråga efter en hel sida kostar samma sak som att fråga efter tio rader.
Autentisering kräver antingen key=sk_... i frågan eller ett Authorization: Bearer sk_...-huvud. CORS är öppet, men behåll nyckeln på din server ändå, eftersom kod i webbläsaren exponeras för varje besökare.
Ordning spelar roll. När du bläddrar igenom resultat, sortera efter DR i fallande ordning för domäner som troligen är viktiga, eller i stigande ordning för att inspektera den långa svansen av små webbplatser. Vilket du än väljer, skriv ner det bredvid filen.
Behandla tabellen ovan som en karta och de sparade svaren som territoriet. Om ett fält du förväntade dig saknas, bygg kring det som finns.
En månatlig export, i fem steg
Kör samma fem steg varje månad, så att de sparade filerna stämmer överens när du jämför dem.
- 1
Välj anropen
Välj
refdomains,anchorsochtoppagesför varje domän. Översikt och statistik är gratis, så lägg till dem i samma mapp. - 2
Fixa djupet
Ställ in
page,per,sortochorderen gång och behåll dem. Per kan gå upp till 5000, men ett enskilt anrop returnerar upp till 1 000 rader. - 3
Spara varje svar oförändrat
Skriv den råa JSON-disken innan någon parsing. Om ett skript misslyckas senare är den sparade kopian det du kör igenom mot.
- 4
Läs _credits-objektet
Varje autentiserat svar rapporterar sin kostnad och det återstående saldot. Kopiera båda till en logg rad, så att månadens utgifter är synliga utan en dashboard.
- 5
Jämför med förra månaden
Diff de sparade kopiorna. Diff-receptet listar de tre kolumner som är värda att behålla.
Krediter, radgränser och en månads faktura
Prislistan är kort. Fakturan beror på hur ofta du anropar och hur du paginerar. Tre vanor bestämmer det mesta av det.
En debitering per anrop, oavsett antal rader
Varje anrop debiteras en gång, så per=1000 kostar samma sak som per=10 för samma åtgärd. En hel sida är det billiga valet för en lista du kommer att återanvända, och ett slösaktigt för en snabb titt.
Säg att du hämtar refdomains för en domän samma dag varje månad. Det är 2 krediter, eller $0.0002, i månaden till det publicerade priset på $0.0001 per kredit.
Takgränsen på 50 000 rader
Djup paginering slutar vid 50 000 rader. En slinga som fortsätter att fråga efter nästa sida efter det får inget nytt, så begränsa sidantalet innan loopen startar.
Att nå taket vid 1 000 rader per anrop tar femtio anrop. Till 2 krediter vardera blir det 100 krediter, eller $0.01. Billigt, men bara om skriptet slutar när det ska.
En liten budget för en månatlig vana
Tänk dig tio domäner, var och en med refdomains och anchors hämtade en gång i månaden. Det är 40 krediter i månaden, eller $0.004, dragna från den fria krediten på $100 vid registrering, vilket är 1 000 000 krediter.
I den taktens varar den fria krediten länge, och utgiftsloggen visar om takten håller. Behåll den.
Felsökning av svar
| Du ser | Orsak | Fix |
|---|---|---|
| HTTP 401 | Nyckel saknas eller felaktig | Kontrollera nyckeln och stavningen av huvudet |
| HTTP 402 | Krediten har tagit slut | Ladda upp med USDT (TRC-20) på kontosidan |
| ok är false | Begäran avvisades | Läs meddelandet i kroppen och parametrarna du skickade |
| Färre rader än vad ett stort paket visar | Olika index och crawltid | Jämför trender, inte totaler |
| En länk du skapade förra veckan saknas | Indexet byggdes om ungefär en gång i månaden | Kontrollera igen nästa cykel |
En saknad rad är en fråga, inte ett svar
En rad som försvinner mellan två svar är en vanlig överraskning. Innan du bestämmer vad den betyder, separera de berättelser den kan berätta.
Tre berättelser bakom en saknad rad
Länken kanske aldrig har indexerats, eller så har den tagits bort. Den tredje berättelsen är timing: sidan crawldes innan eller efter en indexuppbyggnad, och raden dyker upp i en senare cykel.
Ett anrop kan inte skilja dessa åt. Endast en andra kopia tagen senare, plus en titt på sidan själv, begränsar listan.
Väg raden innan du jagar den
Kontrollera domänens DR och den länkande sidan innan någon outreach. En borttagen länk från en svag webbplats ändrar sällan en plan. En borttagen länk från en sida som lockade läsare kan förtjäna en anteckning till dess ägare. Misstänksamma tabellen visar var en saknad rad sitter bland de bredare orsakerna.
Att flytta en export till våra anrop
Kan jag exportera samma kolumner som Ahrefs ger mig?
Inte en mot en. Radfält varierar beroende på åtgärd, så öppna ett sparade svar och mappa namnen själv. Tabellen ovan anger den närmaste åtgärden för varje del av en rapport, men fältnamnen kommer att skilja sig.
Är API:t billigare än ett Ahrefs-abonnemang?
Svaret beror på anropsvolymen. Vårt publicerade pris är $0.10 per 1 000 anrop med en kredit. Ahrefs säljer API-enheter i abonnemang, från $129 i månaden för 200 000 enheter, med minst 50 enheter per begäran. Räkna dina anrop innan du bestämmer.
Kommer gamla exporter fortfarande att jämföras med nya?
Endast om sorteringen, djupet och källan matchar. En fil hämtad från ett annat verktyg en annan vecka är ett annat urval. Behåll de gamla filerna och starta den nya serien med ett tydligt märkt par.
Måste jag behålla nyckeln på min server?
Ja. CORS är öppet, så en webbläsare kan anropa API:et, men en nyckel i front-end-kod är synlig för varje besökare. Skicka begäranden från din server och läs nyckeln från en miljövariabel.
Innan du bygger en rapport ovanpå dessa anrop
- Öppna ett sparade svar per åtgärd och notera de radfältnamn du faktiskt får.
- Bestäm vilken månadsetikett som ska gå in i varje filnamn.
- Håll
page,per,sortochorderidentiska mellan månatliga drag. - Logga
_credits-objektet från varje autentiserat svar så att utgifterna per jobb är synliga. - Begränsa djup paginering i ditt skript, eftersom listor slutar vid 50 000 rader.
- Lägg till en färskehetsanteckning till alla rapporter du lämnar över, som säger att indexet uppdateras ungefär en gång i månaden.
Att läsa kuvertet
Varje svar bär ok. Autentiserade svar lägger också till _credits, så att du kan logga utgifter per jobb och hålla koll på saldot.
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 säljer API-enheter i abonnemang, från $129 i månaden för 200 000 enheter med 50 enheter minimum per begäran. Det erbjuder också nyckelord, rangspårning och en färskare crawl, och det gör Semrush också. Vi täcker länkdata till ett lågt pris per anrop och inget utöver det. Använd månadsdriftboken om det är gapet du behöver fylla. Beslutsträdet för spamtoppar är en bra första användning av de billiga sammanfattningsanropen.
