Naar de inhoud springen
SEO Uptr
SEO UptrAanmelden

Referentie

Referentie voor de backlinks api: acties, kosten en fouten

Één pagina met de feiten die een monitor nodig heeft: wat elke actie kost, hoe paginatie werkt en wat de api doet als er iets misgaat.

Stenen brug over rivier met een klein bootje dat eronder vaart

Acties op kredietkosten

1 krediet = $0.0001. Elke aanroep wordt één keer gefactureerd, ongeacht het aantal rijen, tot 1.000 rijen per aanroep.
KostenActiesOpmerkingen
Gratis, geen sleutel nodigdomain, overview, stats, suggestGeschikt voor dashboards en de DR checker
1 kredietbulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr accepteert maximaal 2.000 domeinen (GET domains= of POST body); compare maximaal 20
2 kredietenrefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect vereist 2 tot 10 domeinen
3 kredietensearch, keywordVolledige tekstzoekopdracht over ankers, titels en URL's; keyword vindt wie gelinkt is met een exact anker

Authenticatie en statuscodes

Geef de sleutel mee als key= of als een bearer header. Controleer de HTTP-statuscode voordat je de body verwerkt.

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

Parameters en fouten

ItemWaardeBetekenis
qeen domeinHet doel van de zoekopdracht
page, perper van 10 tot 5000Paginatie; het aantal rijen per aanroep is beperkt tot 1.000, diepe paginatie tot 50.000
sort, orderorder=asc of descSortering van de geretourneerde rijen
okin elke responseOf de aanroep succesvol was
_creditsalleen bij geauthenticeerde responsesKosten van de aanroep en resterend saldo
HTTP 401ontbrekende of ongeldige sleutelControleer de sleutel of header
HTTP 402krediet opgebruiktLaad op met USDT (TRC-20)
Timmerman die hout meet en gereedschap selecteert op een werkbank in een werkplaats

De aanroep ontwerpen voordat je hem plant

De meeste api-problemen beginnen bij het verzoek. Niet bij de response. Een seo backlinks api-integratie bestaat voornamelijk uit een reeks kleine beslissingen die je neemt voordat de eerste aanroep plaatsvindt. Regel eerst de sleutel, de paginagrootte en de sorteervolgorde.

Houd de sleutel buiten het script

Sla de sleutel op in een omgevingsvariabele of een secret store, niet in een bestand dat je committet. Geef het door als de parameter key of als een bearer header. De header houdt de sleutel buiten adressen die vaak in logs terechtkomen.

Plak geen live sleutel in een ticket of chat. Behandel een sleutel die in een gedeelde log verschijnt als blootgesteld.

Kies de paginagrootte met opzet

De parameter per loopt van 10 tot 5000, maar een aanroep wordt één keer gefactureerd voor maximaal 1.000 rijen, dus grotere pagina's betekenen minder kosten. Stel dat je 3.400 rijen nodig hebt. Dat vereist vier aanroepen van 1.000 rijen, niet 340 aanroepen van 10.

Houd de paginagrootte gelijk over runs heen, zodat de bestanden op elkaar aansluiten.

Vast de sorteervolgorde vast

Stel sort en order expliciet in in plaats van te vertrouwen op een standaard. Identieke parameters zorgen ervoor dat de output van week tot week vergelijkbaar is, zodat een diff echte veranderingen laat zien en niet door elkaar geschoven rijen.

Een gewijzigde volgorde is een eenvoudige manier om een valse alarm te creëren.

De cijfers interpreteren

De data is ons eigen linkgraph: 181.132.097 domeinen, 2.774.625.913 domein-tot-domein-links en ongeveer 798,5 miljard backlinks. Het wordt ongeveer één keer per maand ververst. Alles wat nieuwer is dan dat, zit er niet in, wat een seo backlinks api het beste wekelijks kan poll-en.

DR is round(100 · log(ref_domains+1) / log(2·10^7)). Het is een logaritme. Daarom scoort 100 verwijzende domeinen 27, 1.000 scoort 41 en 10.000 scoort 55, dus je linktelling verdubbelen voegt slechts een paar punten toe. Gebruik DR om sites tegen elkaar te rangschikken en de ruwe telling voor alerts, zoals de severity table doet.

Prijzen zijn prepaid. Er is geen abonnement en geen minimum. Het aanmeldkrediet bedraagt $100, wat overeenkomt met 1.000.000 kredieten. Vergelijk dit met Ahrefs API-eenheden, verkocht in abonnementen vanaf $129/maand voor 200.000 eenheden, met minimaal 50 eenheden per verzoek.

Kostenplanning is eenvoudige vermenigvuldiging. Een wekelijkse refdomains-aanroep voor één site kost 2 kredieten keer 4, oftewel 8 kredieten per maand, wat $0,0008 is. Tien sites kosten tien keer dat bedrag. Het lost-link recipe en de competitor job gebruiken beide alleen acties uit de tabel hierboven.

Een fout lezen zonder te raden

Een foutcode vertelt je wie er actie moet ondernemen. Lees het zo. De response wordt dan een routingbeslissing, geen raadsel. De twee codes die het meest belangrijk zijn voor een monitor zijn 401 en 402.

401 en 402 zijn verschillende problemen

Een 401 betekent dat de sleutel ontbreekt of fout is, en er zal niets slagen totdat iemand dat oplost. Een 402 betekent dat het account geen krediet meer heeft, en een top-up lost dit op. Routeer ze naar verschillende eigenaars, zodat de juiste persoon het bericht ziet.

Stuur beide naar een persoon. Een monitor die stil faalt, is erger dan een monitor die nooit draaide.

Controleer de status voordat je de body leest

Lees eerst de HTTP-status en daarna het veld ok. Een response kan als JSON worden verwerkt en toch een fout bevatten, dus de check is pas compleet als beide slagen. Log de status bij elke run, ook de succesvolle.

Herhaal alleen wat kan herstellen

Een 401 herhalen verspillt aanroepen en vult logs met dezelfde fout. Een netwerktime-out is anders. Herhaal dit een klein aantal keren met een pauze tussen de pogingen, en stop dan.

Een run die stopt en een alert genereert, is nuttiger dan een retry-lus die de fout verbergt tot het saldo op is.

Log de status bij elke run

Schrijf de HTTP-status en het saldo naar de log bij elke run, inclusief de succesvolle. Als een run drie weken later faalt, is die regel het eerste dat je wilt zien.

Gratis acties eerst

domain, overview, stats en suggest hebben geen sleutel nodig en kosten niets. Gebruik ze om een domeinnaam, een exacte spelling of een ruwe grootte te controleren voordat je een enkel krediet uitgeeft aan een betaalde actie.

Voordat je een aanroep in cron zet

  • De kosten van de actie zijn bekend en worden vermenigvuldigd met het aantal runs per maand.
  • Exitcode en HTTP-status worden beide gecontroleerd.
  • Een 402 stuurt een alert naar een mens.
  • Responses worden gesorteerd opgeslagen, zodat diffs schoon blijven.
  • De frequentie komt overeen met de maandelijkse verversing.
Tuinman die planten in nette rijen in een tuin arrangeert

Opmerkingen over paginatie

Volgorde doet ertoe. Gebruik per=1000 voor snapshots en houd dezelfde sort en order elke week aan. Als de volgorde verandert tussen runs, laat een diff ruis zien. Dat is een klassieke oorzaak van valse alarmen.

Grotere sites? Voor een site met meer dan 1.000 verwijzende domeinen, blader door met page=1, page=2 en zo verder. Elke pagina is een aparte gefactureerde aanroep. Diepe paginatie is beperkt tot 50.000 rijen, wat bijna elke gewone site dekt.

Vragen over de referentie

Welke actie moet ik eerst aanroepen als ik niet zeker weet hoe een domein eruit ziet?
Begin met overview of domain. Beide zijn gratis en vereisen geen sleutel, en ze tonen een ruwe grootte en de basisstructuur van de data. Gebruik kredieten voor refdomains of anchors pas daarna.
Wat kost een volledige check van één domein?
Tel de kredieten van elke actie op en vermenigvuldig dit met hoe vaak het draait. Stel je een refdomains-aanroep, een anchors-aanroep en een tld_breakdown-aanroep voor op één domein, wekelijks. Dat is 2 + 2 + 1 = 5 kredieten per run, oftewel $0,0005. Over vier weken komt dit neer op ongeveer $0,002.
Waarom komen twee tellingen voor hetzelfde domein mogelijk niet overeen?
Vergelijk gelijksoortigs: dezelfde actie, dezelfde parameters en dezelfde verversingsperiode. Tellingen van verschillende acties zijn niet uitwisselbaar, en een telling die tijdens een verversing wordt genomen, kan verschillen van een telling die een week later wordt uitgevoerd.
Hoe test ik een cron-job zonder kredieten te uitgeven?
Voer eerst de gratis acties uit om de bedrading, de statusafhandeling en het uitvoerformaat te controleren. Voer daarna één betaalde aanroep uit om de cijfers te bewijzen, en beperk de job tot één run tijdens het testen.
Werkt paginatie voor een site met meer dan 1.000 verwijzende domeinen?
Ja. Gebruik page met per. Elke pagina is een aparte gefactureerde aanroep, en diepe paginatie is beperkt tot 50.000 rijen, wat de meeste gewone sites dekt.

Een monitor die een slechte week overleeft

Een monitor verdient vertrouwen in de weken waarin niets goed gaat. Plan voor een trage response, een veranderd saldo en een gedeeltelijk resultaat voordat de eerste run plaatsvindt. Dit zijn gewone gebeurtenissen. Elke gebeurtenis moet een duidelijke regel in de log achterlaten.

Time-outs en gedeeltelijke pulls

Stel een time-out in op elke aanroep, zodat één trage response de hele job niet kan vasthouden. Als een pagina van een multi-page pull faalt, registreer dan welke pagina het was en herstart vanaf daar. Je betaalt dan niet twee keer voor rijen die je al hebt.

Markeer een gedeeltelijk bestand als gedeeltelijk in plaats van het op te slaan als een normale snapshot. Anders toont de volgende diff een verlies dat niet heeft plaatsgevonden.

Saldocontroles

Lees _credits bij elke geauthenticeerde response en schrijf het resterende saldo naar de log. Een klein script kan dit vergelijken met een door jou gekozen minimum en een waarschuwing sturen voordat de volgende run plaatsvindt.

Stel dat het minimum 500 kredieten is. Een wekelijkse run die 40 kredieten kost, laat ruimte om op te laden voordat een 402 midden in de nacht arriveert.

Houd elke job saai

Geef elke job één bestand en één schema. Een cron-entry die drie dingen doet, kan op drie manieren falen, en de log kan niet altijd zeggen welke dat was. Twee kleine jobs zijn makkelijker te vertrouwen dan één slimme.

Pas het schema aan bij de verversing

Pas het schema van de job aan bij de maandelijkse verversing in plaats van bij de klok. Een dagelijkse run levert de meeste dagen hetzelfde bestand op, wat kosten en ruis toevoegt zonder informatie toe te voegen. Wekelijks is meestal genoeg.