Riferimento
Riferimento: ogni azione, quanto costa, come fallisce
Tieni questo file aperto mentre scrivi lo script per il tuo audit. Elenca le azioni, i prezzi, i limiti di paginazione e i due errori che probabilmente incontrerai.
Nozioni di base prima delle tabelle
L'endpoint è https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Puoi inviare la chiave come header Bearer. CORS è aperto, quindi funziona anche uno script nel browser.
Ogni risposta include un flag ok. Quelle autenticate riportano anche _credits, che indica il costo e il tuo saldo residuo. Questo rende il monitoraggio del budget semplice.
Rispetto ai prezzi dell'API Moz Backlinks, la struttura è diversa: Ahrefs vende unità all'interno di abbonamenti a partire da $129 al mese per 200.000 unità, mentre qui paghi per chiamata da un saldo prepagato.
Non ci sono livelli di abbonamento da scalare né minimi mensili. Un saldo prepagato significa che non ci sono bolle per eccedenza. Una regola vale per tutti. Uno script che gira una volta al mese e uno che gira per ogni onboarding di cliente pagano secondo la stessa regola. I nuovi iscritti iniziano con $100 di credito gratuito, sufficienti per circa 500.000 chiamate da due crediti.
Scrivere il primo script senza sorprese
Inizia con poco. Uno script che chiama l'API è semplice da scrivere e facile da far esplodere nei costi. Le regole seguenti mantengono la prima versione onesta.
Limita la prima esecuzione a un dominio. Una volta che l'output sembra corretto, amplia l'elenco a step e leggi il saldo tra ogni passaggio.
Le pagine sono l'unità di costo
Una chiamata viene fatturata una volta sola, indipendentemente dal numero di righe restituite. Una pagina che recuperi è un'altra chiamata, quindi navigare in una lista grande costa una fatturazione per pagina.
Immagina un sito con 2.500 domini che linkano e vuoi ottenerli tutti. Alla dimensione di pagina che scegli, sono poche chiamate, e ognuna ha il suo costo. Conta le pagine prima di avviare il loop. Scegli una dimensione di pagina adatta alla domanda: una lista breve richiede una chiamata, una lunga richiede la stessa attenzione per ogni pagina.
Leggi i crediti su ogni risposta
Ogni risposta autenticata include _credits, che indica quanto è costata la chiamata e quanto rimane. Registra quel campo invece di un numero che hai stimato a mente.
Uno script che scrive il saldo nel suo output ti permette di fermarti prima che una lunga esecuzione esaurisca l'account. Mantieni il controllo semplice e visibile.
Usa le chiamate gratuite per testare il piano
domain, overview, stats e suggest non richiedono chiave e sono gratuite. Usale per confermare l'ortografia del dominio e la struttura base dei dati prima di qualsiasi chiamata a pagamento.
Solo allora aggiungi le chiamate a pagamento, una alla volta, sullo stesso dominio. Un errore catturato su una chiamata gratuita non costa nulla. Tieni gli output gratuiti nella stessa cartella datata di quelli a pagamento.
Azioni gratuite e da un credito
| Azione | Costo | A cosa serve |
|---|---|---|
| domain | Gratuito | Ricerca rapida DR, la chiamata dietro il checker nella home page |
| overview | Gratuito | Numeri chiave per un dominio |
| stats | Gratuito | Cifre sull'indice stesso |
| suggest | Gratuito | Ricerca stile autocomplete per i domini |
| bulk_dr | 1 credito | Fino a 2.000 domini per chiamata, GET con domains= o un body POST |
| compare | 1 credito | Fino a 20 domini affiancati |
| top | 1 credito | Una lista classificata dal nostro indice |
| dr_distribution | 1 credito | Come DR si distribuisce su un set |
| tld_breakdown | 1 credito | Referrer raggruppati per TLD |
Azioni da due e tre crediti
| Azione | Costo | A cosa serve |
|---|---|---|
| refdomains | 2 crediti | Domini che linkano a un target |
| backlinks | 2 crediti | Link individuali |
| anchors | 2 crediti | Lista anchor text |
| toppages | 2 crediti | Pagine che attraggono link |
| anchor_cloud | 2 crediti | Parole anchor ponderate per l'uso |
| intersect | 2 crediti | Chi linka a 2-10 domini contemporaneamente, per la ricerca di link di ricambio |
| search | 3 crediti | Ricerca full-text su anchor, titoli e URL |
| keyword | 3 crediti | Chi è linkato con un anchor esatto |
Una chiamata viene fatturata una volta sola, indipendentemente dal numero di righe, fino a 1.000 righe per chiamata. Usa page e per (10-5000) per scorrere i risultati, ordina con sort più order=asc|desc. La paginazione profonda si ferma a 50.000.
Errori che potresti vedere
| Codice HTTP | Significato | Cosa fare |
|---|---|---|
| 401 | Chiave mancante o non valida | Verifica il parametro key o l'header |
| 402 | Crediti esauriti | Ricarica con USDT (TRC-20) dalla pagina account |
Quando una chiamata fallisce e cosa controllare per primo
Due errori coprono la maggior parte dei fallimenti nella pratica. Ognuno ha una soluzione diversa, quindi leggi il codice prima di modificare qualcos'altro.
Una chiamata fallita ti dice comunque qualcosa. Tieni l'URL della richiesta, l'ora e il body della risposta nel log, con la chiave rimossa.
Un 401 significa che la chiave non è accettata
Una risposta 401 dice che la chiave è mancante o non valida. La soluzione è nella richiesta, non nei dati. Verifica il parametro key o l'header Bearer e assicurati che il valore sia stato copiato per intero. Non stampare mai la chiave durante il debug.
Immagina che uno script funzioni sul tuo laptop ma fallisca su un server. Un 401 lì spesso significa che la variabile d'ambiente non è mai stata impostata su quella macchina.
Un 402 significa che il saldo è esaurito
Una risposta 402 significa che i crediti sono esauriti. Nessun dato è sbagliato, e ritentare la stessa chiamata fallirà allo stesso modo finché non ricarichi.
Le ricariche avvengono in USDT sulla rete TRC-20 dalla pagina account. Controlla il saldo prima di una lunga esecuzione, così lo script non si ferma a metà di una lista. Imposta anche una soglia di avvertimento, poiché un avviso anticipato costa molto meno di un audit interrotto.
Ritenti senza sprechi
Ritenta solo gli errori che possono cambiare, come un timeout. Un 401 o 402 ritentato in un loop aggiunge rumore al log e nessun dato all'audit.
Fai una pausa tra i tentativi e tieni il dominio fallito in una lista separata così puoi eseguirlo di nuovo per scopo piuttosto che per caso. Scrivi la regola di retry in un commento in cima allo script, così la prossima modifica la manterrà.
Quale azione per quale domanda di recovery
Abbina la domanda che hai alla chiamata più economica che la risponde.
Quanto è grande il danno?
Inizia con overview, che è gratuito. Poi esegui refdomains una volta e confrontalo con il file che hai salvato il mese scorso. La nostra routine mensile mostra il diff.
Come appaiono i link junk?
Usa anchors e anchor_cloud. Parole strane che si ripetono su molti domini sono il pattern da catturare prima di aprire i miti sul disavow.
Quali donori valgono la pena di perseguire?
intersect prende da due a dieci domini e restituisce siti che linkano a diversi di essi. Inserisci i tuoi rivali, cerca i donori che ti ignorano, poi valuta la lista con bulk_dr.
La migrazione ha perso link?
toppages sul vecchio e sul nuovo dominio mostra dove atterrano i link. Il walkthrough della migrazione lo usa passo dopo passo.
Un audit una tantum in quattro chiamate
Questo ordine mantiene le chiamate a pagamento poche e ognuna legata a una domanda. Esegui una volta per dominio, poi ripeti le chiamate a pagamento ogni mese con le stesse impostazioni.
Esegui le chiamate gratuite
Inizia con overview e domain. Entrambe sono gratuite e il loro output stabilisce la scala per ogni chiamata a pagamento che segue.
Recupera i domini che linkano
Usa refdomains a 2 crediti per chiamata. Conta prima le pagine, poi decidi quanti ne avrai bisogno.
Controlla il mix di anchor
Esegui anchors o anchor_cloud a 2 crediti ciascuno. Cerca parole strane che si ripetono su molti domini.
Valuta la lista dei candidati
Alimenta i domini dubbi a bulk_dr a 1 credito per chiamata, che gestisce fino a 2.000 domini. Tieni i punteggi nello stesso file dei domini che linkano.
Una chiamata paginata, annotata
Tutti i parametri dopo l'azione sono facoltativi.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsUn confronto equo con un'alternativa all'API Moz Backlinks
I confronti equi partono dalle stesse unità. Le pagine dei prezzi spesso nascondono l'unità, quindi annota cosa paghi effettivamente per ogni risposta prima di confrontare i totali.
Su Ahrefs, le unità sono incluse in un abbonamento, che parte da $129 al mese e compra 200.000 unità. Ogni richiesta usa almeno 50 di esse. Questa è la trappola. Mettilo accanto a un prezzo per chiamata, e solo allora il confronto ha senso.
Un test alla pari
Scegli cinque domini di dimensione nota ed esegui le stesse domande su entrambi i servizi. Confronta le risposte di cui hai bisogno, non le funzionalità che ammiri.
Immagina che un servizio restituisca i domini che linkano in una singola chiamata e un altro ne richieda tre. Il costo per risposta conta allora più del prezzo di listino.
Prezzi nelle stesse unità
Converti tutto in costo per risposta. Le nostre chiamate sono prezzate in crediti a $0,0001 ciascuno, quindi una chiamata da due crediti costa $0,0002 e una chiamata gratuita non costa nulla. Immagina che un'esecuzione mensile usi sette crediti. Sono $0,0007, meno di un decimo di centesimo.
Includi il costo degli sprechi, come i ritentativi dopo una chiamata fallita. Una chiamata economica che fallisce spesso può finire per costare più di una più costosa che funziona al primo tentativo.
Dove una suite completa vince ancora
Ricerca keyword, rank tracking e crawling giornaliero sono esterni a questa API. Se quelle sono le tue domande, una suite completa le risponde meglio e il confronto dovrebbe dirlo.
Usa il registro per la domanda che risponde bene: come è cambiato il profilo link e quali donori valgono uno sguardo più attento. Indica il gap nelle tue note, ad esempio nessun dato keyword qui, così il prossimo lettore non assume che il registro lo copra.
