Riferimento
Riferimento API Backlinks: azioni, costi ed errori
Una pagina con i dati essenziali per un monitor: quanto costa ogni azione, come funziona la paginazione e come gestisce l'API gli errori.

Azioni in base al costo in crediti
| Costo | Azioni | Note |
|---|---|---|
| Gratuito, senza chiave | domain, overview, stats, suggest | Ideale per dashboard e checker DR |
| 1 credito | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr accetta fino a 2.000 domini (GET domains= o POST body); compare fino a 20 |
| 2 crediti | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect richiede da 2 a 10 domini |
| 3 crediti | search, keyword | Ricerca full-text su anchor, titoli e URL; keyword trova chi è linkato con un anchor esatto |
Autenticazione e codici di stato
Passa la chiave come key= o come header bearer. Controlla il codice HTTP prima di analizzare il body.
# 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 ed errori
| Elemento | Valore | Significato |
|---|---|---|
q | un dominio | Il bersaglio della ricerca |
page, per | per da 10 a 5000 | Paginazione; le righe per chiamata sono limitate a 1.000, la paginazione profonda a 50.000 |
sort, order | order=asc o desc | Ordinamento delle righe restituite |
ok | in ogni risposta | Indica se la chiamata è andata a buon fine |
_credits | solo nelle risposte autenticate | Costo della chiamata e saldo residuo |
| HTTP 401 | chiassa mancante o errata | Controlla la chiave o l'header |
| HTTP 402 | crediti esauriti | Ricarica con USDT (TRC-20) |

Progettare la chiamata prima di schedolarla
La maggior parte dei problemi API nasce nella richiesta, non nella risposta. Un'integrazione seo backlinks api consiste principalmente in una serie di piccole decisioni prese prima della prima chiamata. Stabilisci prima la chiave, la dimensione della pagina e l'ordine di ordinamento.
Tieni la chiave fuori dallo script
Archivia la chiave in una variabile d'ambiente o in un vault dei segreti, non in un file che fai commit. Passala come parametro key o come header bearer. L'header tiene la chiave fuori dagli indirizzi che tendono a finire nei log.
Non incollare una chiave live in un ticket o in una chat. Tratta come esposta una chiave che appare in un log condiviso.
Scegli la dimensione della pagina con criterio
Il parametro per va da 10 a 5000, ma una chiamata viene fatturata una volta sola per fino a 1.000 righe, quindi pagine più grandi significano meno addebiti. Supponiamo di aver bisogno di 3.400 righe. Serviranno quattro chiamate da 1.000 righe, non 340 chiamate da 10.
Mantieni la dimensione della pagina costante tra le esecuzioni per allineare i file.
Blocca l'ordine di ordinamento
Imposta sort e order esplicitamente invece di fidarti del default. Parametri identici rendono l'output confrontabile da settimana a settimana, così un diff mostra un cambiamento reale e non righe riordinate.
Un ordine cambiato è un modo facile per creare un falso allarme.
Leggere i numeri
I dati sono il nostro link graph: 181.132.097 domini, 2.774.625.913 link tra domini e circa 798,5 miliardi di backlink. Si aggiorna circa una volta al mese. Qualcosa di più recente non sarà presente, motivo per cui una seo backlinks api è meglio interrogata settimanalmente.
DR è round(100 · log(ref_domains+1) / log(2·10^7)). È un log. Per questo, 100 domini di riferimento valgono 27, 1.000 valgono 41 e 10.000 valgono 55, quindi raddoppiare il numero di link aggiunge solo pochi punti. Usa DR per classificare i siti tra loro e il conteggio grezzo per gli alert, come fa la tabella di severità.
I prezzi sono prepagati. Non ci sono abbonamenti e nessun minimo. Il credito di registrazione è $100, che corrisponde a 1.000.000 di crediti. Confrontalo con le unità API di Ahrefs, vendute in piani da $129/mese per 200.000 unità, con almeno 50 unità per richiesta.
Il piano dei costi è una semplice moltiplicazione. Una chiamata settimanale refdomains per un sito è 2 crediti per 4, ovvero 8 crediti al mese, che sono $0.0008. Dieci siti costano dieci volte tanto. La ricetta per i link persi e il lavoro competitor usano solo azioni dalla tabella sopra.
Leggere un errore senza indovinare
Un codice di errore ti dice chi deve agire. Leggilo in questo modo. La risposta diventa così una decisione di routing, non un mistero. I due codici più importanti per un monitor sono 401 e 402.
401 e 402 sono problemi diversi
Un 401 significa che la chiave è mancante o errata e nulla andrà a buon fine finché qualcuno non la sistema. Un 402 significa che l'account è senza crediti e una ricarica lo risolve. Indirizzali a proprietari diversi in modo che la persona giusta veda il messaggio.
Invia entrambi a una persona. Un monitor che fallisce in silenzio è peggio di uno che non è mai partito.
Controlla lo stato prima del body
Leggi prima lo stato HTTP e poi il campo ok. Una risposta può essere parsata come JSON e comunque contenere un errore, quindi il controllo è completo solo quando entrambi passano. Registra lo stato ad ogni esecuzione, anche quelle riuscite.
Riprova solo ciò che può recuperare
Riprova un 401 spreca chiamate e riempie i log con lo stesso errore. Un timeout di rete è diverso. Riprovalo un piccolo numero di volte con una pausa tra i tentativi, poi fermati.
Un'esecuzione che si ferma e invia un alert è più utile di un loop di retry che nasconde il fallimento finché il saldo non è esaurito.
Registra lo stato ad ogni esecuzione
Scrivi lo stato HTTP e il saldo nel log ad ogni esecuzione, incluse quelle riuscite. Quando un'esecuzione fallisce tre settimane dopo, quella riga sarà la prima cosa che vorrai vedere.
domain, overview, stats e suggest non richiedono chiave e costano zero. Usale per verificare la correttezza di un nome di dominio, una spelling esatta o una dimensione approssimativa prima di spendere un solo credito per un'azione a pagamento.
Prima di mettere una chiamata in cron
- Il costo dell'azione è noto e moltiplicato per le esecuzioni al mese.
- Vengono controllati sia il codice di uscita che lo stato HTTP.
- Un 402 invia un alert a un umano.
- Le risposte vengono salvate ordinate, così i diff restano puliti.
- La cadenza corrisponde all'aggiornamento mensile.

Note sulla paginazione
L'ordine conta. Usa per=1000 per gli snapshot e mantieni lo stesso sort e order ogni settimana. Se l'ordine cambia tra le esecuzioni, un diff mostrerà rumore. È una causa classica di falsi allarmi.
Siti più grandi? Per un sito con più di 1.000 domini di riferimento, scorri con page=1, page=2 e così via. Ogni pagina è una chiamata fatturata separata. La paginazione profonda è limitata a 50.000 righe, che coprono quasi tutti i siti ordinari.
Domande sul riferimento
- Quale azione dovrei chiamare per prima quando non sono sicuro di come appare un dominio?
- Inizia con
overviewodomain. Entrambi sono gratuiti e non richiedono chiave, e mostrano una dimensione approssimativa e la forma di base dei dati. Spendi crediti surefdomainsoanchorssolo dopo. - Quanto costa un controllo completo di un dominio?
- Somma i crediti di ogni azione, poi moltiplica per la frequenza di esecuzione. Immagina una chiamata
refdomains, unaanchorse unatld_breakdownsu un dominio, settimanalmente. Sono 2 + 2 + 1 = 5 crediti per esecuzione, o $0.0005. In quattro settimane ammontano a circa $0.002. - Perché due conteggi per lo stesso dominio potrebbero non corrispondere?
- Confronta come con come: la stessa azione, gli stessi parametri e lo stesso periodo di aggiornamento. I conteggi di azioni diverse non sono intercambiabili e un conteggio fatto a metà aggiornamento può differire da uno fatto una settimana dopo.
- Come testare un job cron senza spendere crediti?
- Esegui prima le azioni gratuite per verificare il cablaggio, la gestione degli stati e il formato dell'output. Poi fai una chiamata a pagamento per provare i numeri e limita il job a una singola esecuzione mentre testi.
- La paginazione funziona per un sito con più di 1.000 domini di riferimento?
- Sì. Usa
pageconper. Ogni pagina è una chiamata fatturata separata e la paginazione profonda è limitata a 50.000 righe, che coprono la maggior parte dei siti ordinari.
Un monitor che sopravvive a una settimana difficile
Un monitor guadagna fiducia nelle settimane in cui nulla va per il meglio. Prevedi una risposta lenta, un saldo cambiato e un risultato parziale prima della prima esecuzione. Sono eventi ordinari. Ognuno dovrebbe lasciare una riga chiara nel log.
Timeout e pull parziali
Imposta un timeout su ogni chiamata, così una risposta lenta non può tenere aperto l'intero job. Se una pagina di un pull multi-pagina fallisce, registra quale pagina era e riavvia da lì. Eviti così di pagare due volte per righe che hai già.
Marca un file parziale come parziale invece di salvarlo come snapshot normale. Altrimenti il prossimo diff mostrerà una perdita che non è mai avvenuta.
Controlli del saldo
Leggi _credits su ogni risposta autenticata e scrivi il saldo residuo nel log. Un piccolo script può confrontarlo con un minimo che scegli e inviare un avviso prima della prossima esecuzione.
Supponiamo che il minimo sia 500 crediti. Un'esecuzione settimanale che costa 40 crediti lascia spazio per ricaricare prima che arrivi un 402 nel mezzo della notte.
Mantieni ogni job noioso
Assegna a ogni job un file e una pianificazione. Un entry cron che fa tre cose può fallire in tre modi, e il log non può sempre dire quale è successo. Due job piccoli sono più facili da fidarsi di uno intelligente.
Abbina la pianificazione all'aggiornamento
Abbina la pianificazione del job all'aggiornamento mensile piuttosto che all'orologio. Un'esecuzione giornalistica restituisce lo stesso file nella maggior parte dei giorni, il che aggiunge costo e rumore senza aggiungere informazioni. Settimanalmente è di solito sufficiente.