Hoppa till innehåll
SEO Uptr
SEO UptrFå $100 gratis

Referens

Backlinks API-referens: åtgärder, kostnader och fel

En sida med fakta som en monitor behöver: vad varje åtgärd kostar, hur paginering fungerar och vad API:et gör när något går fel.

Stenbro över flod med en liten båt som seglar under

Åtgärder efter kreditkostnad

1 kredit = $0.0001. Varje anrop debiteras en gång oavsett antal rader, upp till 1 000 rader per anrop.
KostnadÅtgärderNoteringar
Gratis, ingen nyckeldomain, overview, stats, suggestBra för dashboards och DR-kontrollen
1 kreditbulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr tar upp till 2 000 domäner (GET domains= eller POST-body); compare upp till 20
2 kreditrefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect tar 2 till 10 domäner
3 kreditsearch, keywordFulltext sökning över ankartexter, titlar och URL:er; keyword hittar vem som länkar med en exakt ankartext

Autentisering och statuskoder

Skicka nyckeln som key= eller som en bearer-header. Kontrollera HTTP-koden innan du parsa body:en.

bash
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
  "https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"

# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
  200) jq '._credits' out.json ;;      # cost and remaining balance
  401) echo 'bad or missing key' ;;
  402) echo 'out of credit: top up' ;;
  *)   echo "unexpected $code" ;;
esac

Parametrar och fel

ObjektVärdeBetydelse
qen domänMålet för sökningen
page, perper från 10 till 5000Paginering; antal rader per anrop är begränsat till 1 000, djup paginering till 50 000
sort, orderorder=asc eller descSortering av returnerade rader
oki varje svarOm anropet lyckades
_creditsendast autentiserade svarAnropets kostnad och återstående balans
HTTP 401saknad eller felaktig nyckelKontrollera nyckeln eller header
HTTP 402krediten är slutLadda upp med USDT (TRC-20)
Snickare som mäter trä och väljer verktyg på en verkstadsbänk

Att designa anropet innan du schemalägger det

De flesta API-problem börjar i begäran. Inte i svaret. En integration av seo backlinks api består mest av små beslut som tas innan det första anropet. Bestäm nyckel, sidstorlek och sorteringsordning först.

Håll nyckeln utanför skriptet

Lagra nyckeln i en miljövariabel eller ett hemlighetslager, inte i en fil du committar. Skicka den som key-parametern eller som en bearer-header. Headern håller nyckeln borta från adresser som tenderar att hamna i loggar.

Klistra inte in en live-nyckel i en biljett eller ett chattfönster. Behandla en som dyker upp i en delad logg som exponerad.

Välj sidstorleken med avsikt

Parametern per går från 10 till 5000, men ett anrop debiteras en gång för upp till 1 000 rader, så större sidor innebär färre debiteringar. Säg att du behöver 3 400 rader. Det kräver fyra anrop med 1 000 rader, inte 340 anrop med 10.

Behåll sidstorleken densamma över körningar så att filerna stämmer överens.

Fäst sorteringsordningen

Ställ in sort och order explicit snarare än att lita på ett standardvärde. Identiska parametrar gör att utdata är jämförbar vecka till vecka, så att en diff visar verklig förändring och inte omblandade rader.

En ändrad ordning är ett enkelt sätt att skapa en falsk alarm.

Att läsa siffrorna

Data är vårt eget länkgraf: 181 132 097 domäner, 2 774 625 913 domän-till-domän-länkar och cirka 798,5 miljarder backlinks. Den uppdateras ungefär en gång i månaden. Allt som är nyare än det finns inte i den, vilket är varför ett seo backlinks api bäst pollas veckovis.

DR är round(100 · log(ref_domains+1) / log(2·10^7)). Det är en logaritm. På grund av detta ger 100 hänvisande domäner 27, 1 000 ger 41 och 10 000 ger 55, så att dubbla ditt länkkantal ger bara några få poäng. Använd DR för att rangordna webbplatser mot varandra och det råda antalet för varningar, som severity table gör.

Prissättningen är förbetald. Det finns inget abonnemang och inget minimum. Registreringskrediten är $100, vilket är 1 000 000 kredit. Jämför det med Ahrefs API-enheter, sålda i planer från $129/månad för 200 000 enheter, med minst 50 enheter per begäran.

Kostnadsplanering är enkel multiplikation. Ett veckovis refdomains-anrop för en webbplats är 2 kredit gånger 4, eller 8 kredit i månaden, vilket är $0.0008. Tio webbplatser kostar tio gånger så mycket. Lost-link recipe och competitor job använder båda bara åtgärder från tabellen ovan.

Att läsa ett fel utan att gissa

En felkod säger vem som måste agera. Läs det så. Svaret blir då en routningsbeslut, inte ett mysterium. De två koderna som är viktigast för en monitor är 401 och 402.

401 och 402 är olika problem

En 401 betyder att nyckeln saknas eller är fel, och inget kommer att lyckas tills någon fixar det. En 402 betyder att kontot är tomt på kredit, och en påfyllning löser det. Routa dem till olika ägare så att rätt person ser meddelandet.

Skicka båda till en person. En monitor som misslyckas tyst är värre än en som aldrig kördes.

Kontrollera statusen innan body:en

Läs HTTP-statusen först och ok-fältet sedan. Ett svar kan parsas som JSON och ändå bära ett fel, så kontrollen är komplett först när båda går igenom. Logga statusen med varje körning, även de lyckade.

Försök igen bara vad som kan återhämta sig

Att försöka igen på en 401 slösar anrop och fyller loggar med samma fel. En nätverkstimeout är annorlunda. Försök igen ett litet antal gånger med en paus mellan försöken, stoppa sedan.

En körning som stannar och varnar är mer användbar än en retry-loop som döljer felet tills balansen är borta.

Logga statusen vid varje körning

Skriv HTTP-status och balans till loggen vid varje körning, inklusive de lyckade. När en körning misslyckas tre veckor senare är den raden det första du vill se.

Gratis åtgärder först

domain, overview, stats och suggest behöver ingen nyckel och kostar ingenting. Använd dem för att kontrollera en domänsnamn, en exakt stavning eller en grov storlek innan du spenderar en enda kredit på en betald åtgärd.

Innan du lägger ett anrop i cron

  • Åtgärdens kostnad är känd och multipliceras med körningar per månad.
  • Exit-kod och HTTP-status kontrolleras båda.
  • En 402 skickar en varning till en människa.
  • Svar sparas sorterade, så diffar förblir rena.
  • Cadensen matchar den månatliga uppdateringen.
Trädgårdsmästare som ordnar växter i raka rader i en trädgård

Noteringar om paginering

Ordning betyder något. Använd per=1000 för ögonblicksbilder och behåll samma sort och order varje vecka. Om ordningen ändras mellan körningar visar en diff brus. Det är en klassisk orsak till falska alarm.

Större webbplatser? För en webbplats med mer än 1 000 hänvisande domäner, bläddra igenom med page=1, page=2 och så vidare. Varje sida är ett separat debiterat anrop. Djup paginering är begränsad till 50 000 rader, vilket täcker nästan alla vanliga webbplatser.

Frågor om referensen

Vilken åtgärd ska jag kalla först när jag inte är säker på hur en domän ser ut?
Börja med overview eller domain. Båda är gratis och behöver ingen nyckel, och de visar en grov storlek och den grundläggande formen på data. Spendera kredit på refdomains eller anchors först efter det.
Vad kostar en fullständig kontroll av en domän?
Lägg ihop varje åtgärds kredit, multiplicera sedan med hur ofta den körs. Tänk dig ett refdomains-anrop, ett anchors-anrop och ett tld_breakdown-anrop på en domän, veckovis. Det är 2 + 2 + 1 = 5 kredit per körning, eller $0.0005. Över fyra veckor blir det cirka $0.002.
Varför kanske två räkningar för samma domän inte stämmer?
Jämför likvärdigt med likvärdigt: samma åtgärd, samma parametrar och samma uppdateringsperiod. Räkningar från olika åtgärder är inte utbytbara, och en räkning tagen mitt under en uppdatering kan skilja sig från en tagen en vecka senare.
Hur testar jag ett cron-jobb utan att spendera kredit?
Kör de gratis åtgärderna först för att kontrollera kopplingen, statushanteringen och utdataformatet. Gör sedan ett betalt anrop för att bevisa siffrorna, och begränsa jobbet till ett enda körning medan du testar.
Fungerar paginering för en webbplats med mer än 1 000 hänvisande domäner?
Ja. Använd page med per. Varje sida är ett separat debiterat anrop, och djup paginering är begränsad till 50 000 rader, vilket täcker de flesta vanliga webbplatser.

En monitor som överlever en dålig vecka

En monitor vinner förtroende under veckorna när inget går rätt. Planera för en långsam respons, en ändrad balans och ett delvis resultat innan den första körningen. Det är vanliga händelser. Varje en ska lämna en tydlig rad i loggen.

Timeouts och delvis hämtning

Ställ in en timeout på varje anrop, så att en långsam respons inte kan hålla hela jobbet öppet. Om en sida i en flersidig hämtning misslyckas, registrera vilken sida det var och starta om därifrån. Du undviker då att betala två gånger för rader du redan har.

Markera en delvis fil som delvis snarare än att spara den som en normal ögonblicksbild. Annars kommer nästa diff att visa en förlust som aldrig hände.

Balanskontroller

Läs _credits vid varje autentiserat svar och skriv återstående balans till loggen. Ett litet skript kan jämföra det med en golvgräns du väljer och skicka en varning innan nästa körning.

Säg att golvet är 500 kredit. En veckokörning som kostar 40 kredit lämnar utrymme att fylla på innan en 402 kommer mitt på natten.

Håll varje jobb tråkigt

Ge varje jobb en fil och ett schema. En cron-post som gör tre saker kan misslyckas på tre sätt, och loggen kan inte alltid säga vilken som hände. Två små jobb är lättare att lita på än ett smart.

Matcha schemat till uppdateringen

Matcha jobbetets schema till den månatliga uppdateringen snarare än till klockan. Ett dagligt anrop returnerar samma fil de flesta dagar, vilket lägger till kostnad och brus utan att lägga till information. Veckovis är vanligtvis tillräckligt.