Documentație
Referință endpoint și tarife
Un URL, multe acțiuni. Aceasta este întreaga suprafață.
Echipa de cercetare SEOCheck ·

Acțiuni și costuri
| Acțiune | Credite | Ce returnează |
|---|---|---|
| domain | gratuit | Înregistrare de bază și DR pentru un domeniu |
| overview | gratuit | Sumarul profilului de linkuri al unui domeniu |
| stats | gratuit | Statistici la nivel de index |
| suggest | gratuit | Sugestii de domenii în timp ce tastezi |
| bulk_dr | 1 | DR pentru până la 2.000 de domenii |
| compare | 1 | Comparație pe rând pentru până la 20 de domenii |
| top | 1 | Domenii top |
| dr_distribution | 1 | Distribuția DR printre domeniile care fac link |
| tld_breakdown | 1 | Linkuri pe domenii de nivel superior |
| refdomains | 2 | Domenii de referință |
| backlinks | 2 | Backlinkuri individuale |
| anchors | 2 | Anchor texts |
| toppages | 2 | Pagini cele mai linkate |
| anchor_cloud | 2 | Greutatea anchor textelor |
| intersect | 2 | Linkeri comuni pentru 2 până la 10 domenii |
| search | 3 | Căutare full-text în anchor texts, titluri și URL-uri |
| keyword | 3 | Cine este linkat cu un anchor exact |
Autentificare și structură
URL de bază: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Preferi header-e? Trimite Authorization: Bearer sk_... în schimb.
Acest API de analiză a backlinkurilor răspunde în JSON și permite apeluri cross-origin, astfel încât un browser poate apela direct. Fiecare răspuns are un câmp ok. Cele autentificate conțin și _credits, care indică costul apelului și soldul tău rămas.
Erorile sunt clare. HTTP 401 înseamnă că cheia lipsește sau este greșită. HTTP 402 înseamnă că soldul s-a epuizat. Ambele sunt ușor de gestionat și niciuna nu ar trebui reîncercată în buclă.
Înainte de primul apel plătit
- Rulează
overviewpe un domeniu pe care îl cunoști. Este gratuit. - Verifică dacă cheia funcționează cu un apel de 1 credit, cum ar fi
compare. - Citește
_creditsdin răspuns și confirmă că costul se potrivește cu tabelul de mai sus. - Setează o alarmă în script pentru HTTP 402, astfel încât un sold gol să nu eșueze în tăcere.
Paginare și sortare
Rândurile pe apel pot ajunge la 1.000. Cere mai puține sau mai multe cu per, de la 10 la 5000, navighează cu page și sortează cu sort și order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Parametri care modifică răspunsul
Fiecare acțiune primește aceleași două elemente de bază, action și q, urmate de un set scurt de opțiuni. Citește-le mai întâi. Majoritatea greșelilor provin din opțiuni care par opționale, dar modifică costul sau structura rândurilor. Citește opțiunile înainte să copiezi un apel dintr-un forum sau un blog.
Exemplele de mai jos presupun o cheie în parametrul key. Înlocuiește placeholder-ul cu al tău. Păstrează cheia într-o variabilă de mediu, nu într-un fișier pe care îl commiti. Fiecare exemplu din această referință API de analiză a backlinkurilor folosește același URL de bază.
Paginare cu page și per
Opțiunea per setează câte rânduri sunt returnate, de la 10 până la 5000. Opțiunea page te mută prin set. Un apel care cere 500 de rânduri și apoi page 2 returnează blocul următor, nu următoarea extragere a aceluiași set de rânduri.
Paginarea profundă se oprește la 50.000 de rânduri. Dacă un job necesită mai mult, restrânge interogarea cu sort sau împarte munca pe domenii, astfel încât fiecare apel să rămână în limitele maxime.
Sortare cu sort și order
Sortează pe server, nu în scriptul tău. Cererea sort=dr&order=desc returnează domeniile care fac link cu cea mai mare putere pe prima pagină, astfel încât rândurile care te interesează să apară imediat. Filtrarea după descărcarea completă pierde timp și credite.
Folosește order=asc când vrei rândurile cu cea mai mică putere, de exemplu pentru a găsi linkuri subțiri sau pentru a identifica o scădere bruscă într-un profil.
Liste: bulk_dr, compare și intersect
Acțiunile de listă acceptă mai multe domenii într-un singur apel. bulk_dr acceptă până la 2.000 de domenii pentru un credit, cu un query string GET sau un body POST. compare acceptă până la 20 de domenii, iar intersect acceptă două până la zece.
Deoarece prețul nu depinde de numărul de rânduri, o listă lungă într-un singur apel este mai ieftină decât multe apeluri scurte. Să presupunem că verifici 1.500 de site-uri prospect luni. Acesta este un singur apel, nu 1.500.
Apelurile de căutare și keyword costă mai mult
Acțiunea search rulează căutare full-text în anchor texts, titluri și URL-uri. Acțiunea keyword întreabă cine este linkat cu un anchor exact. Ambele costă trei credite pe apel, așa că folosește-le pentru a răspunde la o întrebare specifică, nu pentru navigare.
Alegerea lui per și page pentru o extragere inițială
Pentru o privire de ansamblu asupra unui domeniu nou, începe cu un per mic, cum ar fi 50. Vei vedea structura rândurilor, numele câmpurilor și costul într-un răspuns scurt. Crește per doar când știi că rândurile sunt ceea ce ai nevoie. Aceeași obișnuință funcționează pentru fiecare acțiune din tabelul de mai sus.
O greșeală comună este să ceri 5.000 de rânduri de la prima încercare și apoi să renunți la majoritatea lor. Răspunsul este mai mare, așteptarea este mai lungă și economisirea așteptată nu apare.
Citirea contorului de credite
Fiecare răspuns autentificat se termină cu _credits, care indică costul acelui apel și soldul tău după acesta. Logheaz-o. Adună la sfârșitul lunii și vei ști factura reală până la cel mai mic cent.
Un buget aproximativ ajută. O mie de apeluri refdomains costă 2.000 de credite, adică $0.20. O mie de apeluri search costă 3.000 de credite, adică $0.30. Un rulaj zilnic bulk_dr pe o listă de 2.000 de domenii costă 1 credit, adică aproximativ $0.003 pe lună.
În comparație cu planurile care încep de la $129 pe lună pentru 200.000 de unități API, așa cum listează Ahrefs, structura facturii este diferită. Vezi comparația pentru detalii.

Citirea erorilor și a câmpului _credits
Un răspuns poate eșua în două moduri diferite, iar codul tău ar trebui să le trateze diferit. Sunt probleme diferite. O cheie greșită este o problemă de configurare. Un sold gol este o problemă de facturare. Gestionarea ambelor ca o singură eroare generică ascunde ce remediu este necesar.
Citește mai întâi câmpul ok. Apoi citește blocul _credits. Abia după aceea ar trebui să te uiți la rânduri, deoarece un rezultat lipsă sau scurt este mai ușor de explicat când știi deja cât a costat apelul.
Gestionează separat 401 și 402
HTTP 401 înseamnă că cheia lipsește sau este greșită. Oprește jobul și corectează cheia. HTTP 402 înseamnă că soldul este epuizat. Completează de pe pagina de cont și continuă. Reîncercarea unui 401 nu ajută niciodată, iar reîncercarea unui 402 fără completare nu ajută nici ea.
Loghează soldul înainte și după un rulaj
Notează soldul _credits la începutul și la sfârșitul unui rulaj. Diferența ar trebui să se potrivească cu ceea ce te așteptai din apelurile efectuate. O creștere mai mare înseamnă că o buclă a rulat de mai multe ori decât ai intenționat.
Pentru o verificare rapidă, înmulțește numărul de apeluri cu costul lor în credite. Dacă răspunsul este 40 și soldul a scăzut cu 4.000, ceva nu este în regulă cu scriptul, nu cu lista de prețuri.
Verifică rândurile pe care le-ai cerut
Un răspuns cu succes care are mai puține rânduri decât așteptat nu este automat o eroare. Un domeniu mic poate avea pur și simplu puține linkuri. Compară numărul de rânduri cu valoarea per pe care ai trimis-o și tratează un gap ca pe o întrebare de răspuns, nu ca pe o defecțiune de ascuns.
Testează mai întâi apelurile ieftine
Înainte să conectezi un apel la un job, rulează-l o dată manual cu cele mai mici opțiuni rezonabile. Verifică răspunsul, numele câmpurilor și valoarea _credits. Un job care se strică pe al doilea rând este mult mai greu de debuguit decât un apel care a eșuat de la prima încercare.
O prima sesiune cu API-ul
Patru apeluri, în ordine, astfel încât fiecare apel ulterior să fie unul pe care îl înțelegi deja. Doar primul este gratuit, și asta este intenționat.
Rulează overview pe un domeniu pe care îl cunoști
Este gratuit și nu necesită cheie. Compară sumarul cu ceea ce vezi în Search Console și pe site în sine, astfel încât să știi cum arată un răspuns normal.
Testează cheia cu un apel de 1 credit
Trimite compare cu domeniul tău și un rival. Confirmă că câmpul ok este true și că _credits indică un cost de un credit.
Extrage o listă de 2 credite cu un per mic
Cere refdomains cu per=50 și sort=dr. Verifică că numărul de rânduri și costul în credite se potrivesc cu tabelul de mai sus.
Scrie costul în log
Înregistrează soldul înainte și după. De acum înainte, fiecare script pe care îl scrii începe cu această obișnuință, iar o factură surpriză devine o linie în log, nu un mister.
Tarife
Credite preplătite. Un credit este $0.0001. Nu există abonament și nici minim lunar.
Acțiuni gratuite
$0
- domain, overview, stats, suggest
- Nu necesită cheie
- Alimentează checker-ul web
Plătește pe măsură ce folosești
$0.10per 1.000 de apeluri de 1 credit
- $100 credit gratuit la înregistrare
- Nu necesită card
- Completează cu USDT (TRC-20)
- Facturat o dată pe apel, nu pe rând
Limite pe care ar trebui să le cunoști
Indexul acoperă 181.132.097 de domenii și 2.774.625.913 linkuri de domeniu. Se reîmprospătează aproximativ lunar. Acesta este mai lent decât un crawl zilnic.
Paginarea profundă se oprește la 50.000 de rânduri. Pentru extrageri mai mari, restrânge interogarea cu sort sau împarte pe domenii.
Autentificarea este doar prin Google, iar completările sunt în USDT. Începe cu DR checker, încearcă o auditare a rivalilor cu ghidul de competitori sau citește de ce unele echipe renunță la API-ul Ahrefs pentru lucrul pur cu linkuri.
FAQ
Plătesc pe rând?
Nu. Un apel este facturat o dată, indiferent dacă returnează 10 rânduri sau 1.000.
Ce se întâmplă când creditele se epuizează?
API-ul returnează HTTP 402. Completează cu USDT (TRC-20) de pe pagina de cont și continuă.
Unde îmi găsesc cheia?
În dashboard după autentificarea Google.