Riferimento
Verifica dei backlink online: azioni, costi, parametri
Un riferimento chiaro per le chiamate utilizzate nei casi pratici. I costi sono espressi in crediti, dove 1 credito corrisponde a $0.0001. Ogni chiamata viene fatturata una sola volta, indipendentemente dal numero di righe restituite.
Azioni raggruppate per prezzo
| Azione | Crediti | Utilizzalo per |
|---|---|---|
domain, overview, stats, suggest | Gratuito, nessuna chiave richiesta | Prima occhiata a un dominio, al suo rating e ai numeri principali |
bulk_dr | 1 | Valuta fino a 2.000 domini in una singola chiamata (GET domains= o tramite body POST) |
compare | 1 | Confronta fino a 20 domini affiancati |
top, dr_distribution, tld_breakdown | 1 | Analizza la struttura: leader, distribuzione dei rating, mix di TLD |
refdomains, backlinks | 2 | Elenchi chi linka a un sito |
anchors, anchor_cloud, toppages | 2 | Leggi le parole utilizzate e le pagine che attirano link |
intersect | 2 | Trova referrer condivisi tra 2 e 10 domini |
search | 3 | Ricerca full-text su anchor text, titoli e URL |
keyword | 3 | Trova chi è linkato con un anchor text esatto |
Richiedi campi, uno alla volta
Sei parametri coprono quasi tutte le chiamate utilizzate nei casi pratici. Ogni voce spiega cosa fa il parametro e dove termina.
action
Indica la chiamata, come overview o intersect. Ogni richiesta ne richiede una, e l'azione determina il prezzo.
q
Il dominio in esame, scritto senza protocollo, per azioni su singolo dominio come overview e refdomains.
domains
Una lista separata da virgole per azioni multi-dominio. intersect accetta da 2 a 10 domini, compare fino a 20, e bulk_dr fino a 2.000 tramite GET o in un body POST.
key
La tua chiave sk_, passata come parametro o come header Authorization: Bearer. Le azioni gratuite funzionano senza chiave.
page e per
page scorre tra i risultati e per imposta le righe per pagina, da 10 a 5000. La paginazione profonda si ferma a 50.000 righe, quindi restringi la domanda prima di paginare così in profondità.
sort e order
sort indica la colonna e order accetta asc o desc. Ordinare i domini di riferimento per rating crescente porta quelli più sottili in cima, dove tendono a emergere le impronte digitali.
Parametri che riutilizzerai
L'autenticazione avviene tramite parametro key o header Authorization: Bearer sk_.... Tieni le chiavi fuori dagli URL che incollerai nella chat, perché le query string finiscono nei log. CORS è aperto, quindi uno strumento browser funziona bene quanto uno script. Comodo.
La paginazione usa page e per, dove per varia da 10 a 5000. Semplice. Una singola chiamata restituisce fino a 1.000 righe, e la paginazione profonda è limitata a 50.000. L'ordinamento usa sort più order=asc o order=desc.
Metti la coda economica prima. Ordinare i domini di riferimento per rating crescente mette i domini sottili in cima, dove compaiono le impronte. Questa abitudine risparmia un'ora.
Mantieni i parametri nello stesso ordine ogni volta. Un ordine fisso rende facile confrontare a occhio due indirizzi salvati e mantiene un diff privo di rumore.
Stima il costo di una chiamata prima di eseguirla
Il prezzo segue l'azione, non il numero di righe. È la regola. Una chiamata refdomains costa 2 crediti, che restituisca un pugno di righe o una pagina intera. Moltiplica il prezzo per il numero di chiamate che prevedi, non per le righe che sperdi di vedere.
Scrivi il piano prima della prima chiamata. Un breve elenco di azioni, domini e chiamate previste è sufficiente. Trasforma un conto sorpresa in una domanda. Rispondi prima.
Per chiamata, non per riga
Ogni chiamata viene fatturata una volta. La paginazione di un elenco lungo è una sola tariffa per pagina richiesta, quindi un valore per più alto può ridurre il numero di addebiti su un recupero lungo. Leggi _credits dopo la prima pagina per confermare il prezzo prima di iterare. Ogni pagina di un recupero paginato è una chiamata separata, quindi conta le pagine prima di iniziare e mantieni per costante su tutte.
Imposta il costo rispetto alla decisione
Valuta il prezzo di una risposta rispetto a ciò che la risposta cambierà. Un controllo del rating che potrebbe alterare un acquisto giustifica un recupero a pagamento. Una semplice curiosità su un concorrente raramente sì. Tieni la decisione e i crediti spesi nella stessa nota.
Chiamate gratuite come filtro
Esegui prima domain, overview e stats. Non costano nulla e mostrano se vale la pena fare un recupero a pagamento. Immagina un dominio la cui overview mostra quasi nessun dominio di riferimento. Potresti non aver bisogno di refdomains affatto, e i crediti risparmiati possono andare altrove. Il metodo di rete usa lo stesso filtro.
Il saldo sul conto
Il saldo si trova in _credits su ogni chiamata con chiave. Leggilo dopo ogni esecuzione e copia la figura accanto al file salvato. Una chiamata che restituisce HTTP 402 significa che i crediti sono esauriti, quindi ricarica prima della prossima esecuzione.
Risposte ed errori
| Cosa ottieni | Significato | Cosa fare |
|---|---|---|
ok in ogni risposta | Il flag da testare prima di leggere qualsiasi altra cosa | Ramifica su di esso nel tuo script |
_credits sulle chiamate con chiave | Costo di questa chiamata e tuo saldo residuo | Registralo accanto all'esibizione |
| HTTP 401 | Chiave mancante o errata | Controlla l'header o il parametro key |
| HTTP 402 | I crediti sono esauriti | Ricarica con USDT (TRC-20) nella pagina dell'account |
Com'è un recupero completato
Un recupero completato per verificare i backlink online è più di un file JSON. Contiene una data, la chiamata, la finestra e una nota su ciò che non può mostrare. Tieni tutti e quattro insieme. Altrimenti il file vale meno ogni mese.
Il corpo grezzo
Salva la risposta esattamente come è arrivata, prima di qualsiasi filtraggio o ordinamento. Un riepilogo che hai scritto tu può essere verificato solo contro il file grezzo, quindi il file grezzo è quello da conservare.
I parametri
Registra l'azione, il dominio o la lista, i valori di paginazione e l'ordine di ordinamento. Due recuperi che differiscono solo per per non sono confrontabili finché quella differenza non è scritta.
La finestra
Indica il ciclo di aggiornamento da cui provengono le cifre e il giorno in cui le hai recuperate. Una cifra senza data sarà contestata con un numero più recente, e la discussione vertirà sulla data piuttosto che sulla scoperta.
I limiti
Scrivi una riga su ciò che la chiamata non ha potuto vedere: link aggiunti dopo l'ultimo aggiornamento, pagine bloccate dai crawler, link dietro un login. La riga impedisce a una scoperta di rivendicare più di quanto i suoi dati possano supportare.
Paginare un elenco lungo senza sprechi
La paginazione è dove i budget scompaiono silenziosamente. Ogni pagina è un'altra chiamata, e un elenco lungo recuperato pagina per pagina può costare più della domanda valeva. Due abitudini lo mantengono onesto.
Ordina prima di paginare
Ordina per la colonna che risponde alla tua domanda, poi scorri tra i risultati. La prima pagina dovrebbe contenere le righe su cui agire. Se non lo fa, cambia l'ordinamento prima di spendere altre chiamate.
Fermati quando la domanda è stata risposta
Un elenco di decine di migliaia di righe raramente è la risposta. Ferma la paginazione una volta che le righe necessarie sono a schermo, salva quella pagina e annota dove ti sei fermato. La nota dice al prossimo lettore cosa è stato lasciato fuori. Lascia il resto non letto a meno che la domanda non cambi.
Errori su cui agire prima
Due codici di stato spiegano la maggior parte delle esecuzioni interrotte. Ognuno ha una soluzione che richiede meno tempo dell'indovinare la causa.
HTTP 401 prima, ogni volta
Un 401 significa che la chiave è mancante o errata, quindi controlla l'header o il parametro prima di qualsiasi altra cosa. Copia la chiave dalla pagina dell'account invece di riscriverla, poiché un carattere sbagliato produce lo stesso errore. Se le chiamate gratuite funzionano e quelle a pagamento falliscono, la chiave è la causa più probabile, perché le azioni gratuite non richiedono alcuna chiave.
HTTP 402 nel mezzo di un'esecuzione
Un 402 interrompe un'esecuzione che funzionava un minuto fa. Ferma il loop, leggi il saldo e ricarica prima della chiamata successiva. Non riprovare in un loop stretto, perché ogni tentativo è una richiesta che non può avere successo finché il saldo non cambia.
Prima di fidarti di una risposta
- Verifica che
oksia true - Annota la data, perché l'indice si aggiorna approssimativamente mensilmente
- Ricorda che DR è round(100 · log(ref_domains + 1) / log(2·10^7)), non un numero di terze parti
- Confronta i domini di riferimento tra gli strumenti, non i totali grezzi dei backlink
- Archivia il file grezzo, non solo il tuo riepilogo
Limiti, dichiarati chiaramente
Questo sono dati sui link a un basso prezzo per chiamata. Non traccia le parole chiave. Non traccia nemmeno i ranking. Ahrefs e Semrush sono prodotti più completi per questo, e Ahrefs vende unità API all'interno di abbonamenti a partire da $129 al mese per 200.000 unità.
Le ricette che usano queste chiamate sono in casistica con curl, e i termini sconosciuti sono nel glossario.
Leggere una risposta con sospetto
Una risposta è una dichiarazione testimoniale. È vera per l'indice nel giorno dello scraping, e silenziosa su tutto ciò che è al di fuori di esso. Chiediti cosa l'indice non ha potuto vedere: pagine bloccate da robots.txt, link aggiunti dopo l'ultimo aggiornamento, link dietro un login. Se vuoi verificare i backlink online senza scrivere codice, il checker sulla home page chiama l'azione gratuita domain.
Verifica incrociata una cosa alla volta manualmente. Scegli un singolo referrer dall'elenco, apri la pagina e trova il link. Semplice. Se c'è, fidati un po' di più del resto. Se non c'è, annota la data e l'URL, e consulta la tabella di troubleshooting.
Non lasciare mai che uno script agisca su una singola lettura. L'allerta va bene, ma cancellare link, inviare file disavow o contattare i proprietari dovrebbe aspettare un essere umano.
