Referință
Referință API backlinks: acțiuni, costuri și erori
O singură pagină cu faptele de care are nevoie un monitor: cât costă fiecare acțiune, cum funcționează paginarea și ce face API-ul când apare o eroare.

Acțiuni în funcție de costul în credite
| Cost | Acțiuni | Note |
|---|---|---|
| Gratuit, fără cheie | domain, overview, stats, suggest | Potrivit pentru panouri de bord și verificatorul DR |
| 1 credit | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr acceptă până la 2.000 de domenii (GET domains= sau corp POST); compare până la 20 |
| 2 credite | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect necesită între 2 și 10 domenii |
| 3 credite | search, keyword | Căutare full-text în anchor text, titluri și URL-uri; keyword identifică cine este legat cu un anchor text exact |
Autentificare și coduri de stare
Transmite cheia ca key= sau ca header bearer. Verifică codul HTTP înainte de a analiza corpul răspunsului.
# 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" ;;
esacParametri și erori
| Element | Valoare | Semnificație |
|---|---|---|
q | un domeniu | Ținta interogării |
page, per | per de la 10 la 5000 | Paginare; numărul de rânduri per apel este limitat la 1.000, paginarea profundă la 50.000 |
sort, order | order=asc sau desc | Sortarea rândurilor returnate |
ok | în fiecare răspuns | Dacă apelul a reușit |
_credits | doar la răspunsurile autentificate | Costul apelului și soldul rămas |
| HTTP 401 | cheie lipsă sau invalidă | Verifică cheia sau headerul |
| HTTP 402 | creditele epuizate | Reîncarcă cu USDT (TRC-20) |

Proiectarea apelului înainte de programarea lui
Majoritatea problemelor API încep în cerere, nu în răspuns. O integrare a seo backlinks api constă în mare parte într-un set de decizii mici luate înainte de primul apel. Stabilește mai întâi cheia, dimensiunea paginii și ordinea de sortare.
Păstrează cheia în afara scriptului
Stochează cheia într-o variabilă de mediu sau într-un depozit de secrete, nu într-un fișier pe care îl comiți. Transmite-o ca parametrul key sau ca header bearer. Headerul ține cheia în afara adreselor care tind să apară în jurnale.
Nu lipi o cheie live într-un tichet sau într-un chat. Tratează una care apare într-un jurnal partajat ca fiind expusă.
Alege dimensiunea paginii intenționat
Parametrul per variază de la 10 la 5000, dar un apel este facturat o dată pentru până la 1.000 de rânduri, deci pagini mai mari înseamnă mai puține charge-uri. Să presupunem că ai nevoie de 3.400 de rânduri. Asta necesită patru apeluri a câte 1.000 de rânduri, nu 340 de apeluri a câte 10.
Păstrează dimensiunea paginii constantă între rulări pentru ca fișierele să se alinieze.
Fixează ordinea de sortare
Stabilește explicit sort și order în loc să te bazezi pe o valoare implicită. Parametrii identici fac ca rezultatele să fie comparabile de la o săptămână la alta, astfel încât un diff să arate o schimbare reală și nu rânduri rearanjate.
O schimbare de ordine este o modalitate simplă de a crea un alarmă falsă.
Citirea numerelor
Datele provin din graful nostru de link-uri: 181.132.097 de domenii, 2.774.625.913 de link-uri între domenii și aproximativ 798,5 miliarde de backlink-uri. Se reîmprospătează aproximativ o dată pe lună. Orice date mai recente decât aceasta nu vor fi incluse, motiv pentru care o api seo backlinks este cel mai bine interogată săptămânal.
DR este round(100 · log(ref_domains+1) / log(2·10^7)). Este un logaritmu. Din acest motiv, 100 de domenii care trimit link-uri au scorul 27, 1.000 au scorul 41 și 10.000 au scorul 55, astfel încât dublarea numărului de link-uri adaugă doar câteva puncte. Folosește DR pentru a clasifica site-urile între ele și numărul brut pentru alerte, așa cum face tabelul de severitate.
Prețul este preplătit. Nu există abonament și nici un minim. Creditul de înregistrare este de $100, ceea ce înseamnă 1.000.000 de credite. Compară acest lucru cu unitățile API Ahrefs, vândute în planuri de la $129/lună pentru 200.000 de unități, cu un minim de 50 de unități per cerere.
Planificarea costurilor este o simplă înmulțire. O apelare săptămânală refdomains pentru un singur site costă 2 credite × 4, adică 8 credite pe lună, ceea ce înseamnă $0,0008. Pentru zece site-uri, costul este de zece ori mai mare. Rețeta pentru link-urile pierdute și job-ul de competitor folosesc doar acțiuni din tabelul de mai sus.
Citirea unei erori fără a ghici
Un cod de eroare îți spune cine trebuie să acționeze. Interpretază-l în acest fel. Răspunsul devine astfel o decizie de rutare, nu un mister. Cele două coduri care contează cel mai mult pentru un monitor sunt 401 și 402.
401 și 402 sunt probleme diferite
Un 401 înseamnă că cheia lipsește sau este greșită și nimic nu va reuși până când cineva nu o remediază. Un 402 înseamnă că contul nu are credite, iar un reîncărcare le rezolvă. Rutarea către proprietari diferiți asigură că persoana potrivită vede mesajul.
Trimite ambele către o persoană. Un monitor care eșuează în tăcere este mai rău decât unul care nu a rulat niciodată.
Verifică statusul înainte de corp
Citește mai întâi statusul HTTP și apoi câmpul ok. Un răspuns poate fi parsat ca JSON și totuși să conțină o eroare, astfel încât verificarea este completă doar când ambele sunt valide. Înregistrează statusul la fiecare rulare, inclusiv pe cele reușite.
Reîncearcă doar ceea ce se poate recupera
Reîncercarea unui 401 irosește apeluri și umple jurnalele cu aceeași eroare. Un timeout de rețea este diferit. Reîncearcă-l de un număr mic de ori, cu o pauză între încercări, apoi oprește-te.
O rulare care se oprește și generează o alertă este mai utilă decât un loop de reîncercare care ascunde eroarea până când soldul se epuizează.
Înregistrează statusul la fiecare rulare
Scrie statusul HTTP și soldul în jurnal la fiecare rulare, inclusiv pe cele reușite. Când o rulare eșuează după trei săptămâni, acea linie este primul lucru pe care vei dori să îl vezi.
domain, overview, stats și suggest nu necesită cheie și nu costă nimic. Folosește-le pentru a verifica raționalitatea numelui de domeniu, a ortografiei exacte sau a dimensiunii aproximative înainte de a cheltui un singur credit pe o acțiune plătită.
Înainte de a pune un apel în cron
- Costul acțiunii este cunoscut și se înmulțește cu numărul de rulări pe lună.
- Codul de ieșire și statusul HTTP sunt ambele verificate.
- Un 402 trimite o alertă către un om.
- Răspunsurile sunt salvate sortate, astfel încât diff-urile rămân curate.
- Ritmul se potrivește cu reîmprospătarea lunară.

Note despre paginare
Ordinea contează. Folosește per=1000 pentru snapshot-uri și păstrează același sort și order în fiecare săptămână. Dacă ordinea se schimbă între rulări, un diff va arăta zgomot. Aceasta este o cauză clasică de alarme false.
Site-uri mai mari? Pentru un site cu mai mult de 1.000 de domenii care trimit link-uri, navighează prin paginare cu page=1, page=2 și așa mai departe. Fiecare pagină este o cerere facturată separat. Paginarea profundă este limitată la 50.000 de rânduri, ceea ce acoperă aproape fiecare site obișnuit.
Întrebări despre referință
- Ce acțiune ar trebui să apelez prima dată când nu sunt sigur cum arată un domeniu?
- Începe cu
overviewsaudomain. Ambele sunt gratuite și nu necesită cheie, și arată o dimensiune aproximativă și forma de bază a datelor. Cheltuiește credite perefdomainssauanchorsdoar după aceea. - Cât costă o verificare completă a unui domeniu?
- Adună creditele fiecărei acțiuni, apoi înmulțește cu frecvența de rulare. Imaginează-ți o apelare
refdomains, unaanchorsși unatld_breakdownpentru un domeniu, săptămânal. Asta înseamnă 2 + 2 + 1 = 5 credite per rulare, adică $0,0005. În patru săptămâni, ajunge la aproximativ $0,002. - De ce s-ar putea ca două numărători pentru același domeniu să nu se potrivească?
- Compară similar cu similar: aceeași acțiune, aceiași parametri și aceeași perioadă de reîmprospătare. Numărătorile din acțiuni diferite nu sunt interschimbabile, iar o numărătoare făcută în timpul unei reîmprospătări poate diferi de una făcută o săptămână mai târziu.
- Cum testez un job cron fără a cheltui credite?
- Rulează mai întâi acțiunile gratuite pentru a verifica conexiunile, gestionarea statusului și formatul de ieșire. Apoi fă un singur apel plătit pentru a dovedi cifrele și limitează job-ul la o singură rulare în timp ce testezi.
- Funcționează paginarea pentru un site cu mai mult de 1.000 de domenii care trimit link-uri?
- Da. Folosește
pagecuper. Fiecare pagină este o cerere facturată separat, iar paginarea profundă este limitată la 50.000 de rânduri, ceea ce acoperă majoritatea site-urilor obișnuite.
Un monitor care supraviețuiește unei săptămâni proaste
Un monitor câștigă încredere în săptămânile în care nu merge nimic bine. Planifică un răspuns lent, un sold schimbat și un rezultat parțial înainte de prima rulare. Acestea sunt evenimente obișnuite. Fiecare ar trebui să lase o linie clară în jurnal.
Timeout-uri și extrageri parțiale
Setează un timeout pentru fiecare apel, astfel încât un răspuns lent să nu poată bloca întregul job. Dacă o pagină dintr-o extragere multi-pagină eșuează, înregistrează care pagină a fost și repornește de acolo. Astfel eviți să plătești de două ori pentru rândurile pe care le ai deja.
Marchează un fișier parțial ca fiind parțial, în loc să îl salvezi ca un snapshot normal. Altfeld, următorul diff va arăta o pierdere care nu s-a întâmplat niciodată.
Verificări de sold
Citește _credits la fiecare răspuns autentificat și scrie soldul rămas în jurnal. Un script mic poate compara acest lucru cu un prag pe care îl alegi și trimite o avertizare înainte de următoarea rulare.
Presupunând că pragul este de 500 de credite. O rulare săptămânală care costă 40 de credite lasă loc pentru reîncărcare înainte ca un 402 să apară în miezul nopții.
Păstrează fiecare job plictisitor
Dă fiecărui job un fișier și un program. O intrare cron care face trei lucruri poate eșua în trei moduri, iar jurnalul nu poate spune întotdeauna care a fost cauza. Două joburi mici sunt mai ușor de încredințat decât unul inteligent.
Potrivește programul cu reîmprospătarea
Potrivește programul jobului cu reîmprospătarea lunară, nu cu ceasul. O rulare zilnică returnează același fișier în majoritatea zilelor, ceea ce adaugă cost și zgomot fără a adăuga informații. Săptămânal este de obicei suficient.