Separa dati dell’indice e ordini
Un’API di dati backlink restituisce osservazioni di un indice; un’API ordini crea o consulta operazioni commerciali. Ricevere dati non pubblica link e una ricevuta non scopre tutto il Web. L’esempio segue DataForSEO v3 Backlinks Live. L’ispettore elabora un file locale senza chiavi o chiamate a pagamento. I domini riservati appartengono a un esercizio inventato, non a una scansione reale.
Verifica la risposta prima delle righe
La documentazione dell’endpoint distingue risposta, attività, richiesta e risultati. Lo strumento richiede un’attività riuscita e un risultato. Un errore non diventa zero backlink; il successo HTTP da solo non basta. Consulta le definizioni degli errori. Conserva destinazione, filtri e raggruppamento. Il fornitore può consolidare riferimenti dalla stessa pagina: una riga non equivale necessariamente a ogni ancora fisica.
Leggi quattro osservazioni inventate
Il file dichiara nove risultati e ne fornisce quattro. I cinque assenti non sono perdite dimostrate. Le righe mostrano follow, sponsored/nofollow, una perdita segnalata e valori ignoti. Le date sono osservazioni storiche del fornitore. False, zero e assenza restano distinti; le coppie ripetute non vengono eliminate. La validazione JSON verifica una struttura supportata, non autentica il fornitore né la verità delle affermazioni.
| Controllo | Valore o campo fittizio | Interpretazione | Non dedurre |
|---|---|---|---|
| Risposta e attività | status_code: 20000 su entrambi i livelli | Struttura riuscita supportata | Nuova verifica delle fonti |
| Totale e ricevuto | total_count: 9; items_count: 4 | Quattro record; risultato parziale | Cinque perdite o inventario completo |
| Fonte e destinazione | url_from; url_to | Conserva coppia esatta | Ogni riga conta tutte le ancore |
| Valori tipizzati | dofollow: false / null | Falso dichiarato e ignoto differiscono | Assente significa follow |
| Osservazione storica | is_lost: true; last_seen: 2026-10-03 | Perdita dichiarata dal fornitore | Cancellazione verificata oggi |
| Contesto richiesta | mode: as_is; backlinks_status_type: all | Conserva ambito insieme ai record | Stesso totale con filtri diversi |
Definisci i limiti prima della spesa
Una vera integrazione richiede segreti lato server, budget approvato e parametri registrati. Controlla prezzi e limiti attuali; salva la risposta originale prima di trasformarla. La paginazione deve conservare l’ambito e confrontare righe ricevute e totale. Non ripetere alla cieca una richiesta pagata dall’esito incerto. Il flag di perdita non è un nuovo controllo di cancellazione. L’API Search Console non espone il rapporto Link: il traffico non lo sostituisce.
Importa localmente e conserva l’originale
Carica l’esempio, incolla JSON compatibile o scegli un file UTF-8. Esamina totale, righe, avviso parziale e contesto. CSV serve alle tabelle, JSON conserva i tipi: testo vuoto e assente diventano celle vuote in CSV. Testi simili a formule ricevono un apostrofo protettivo. Scarica modulo, script da terminale ed esempio nella stessa cartella. I comandi Node.js sotto non usano la rete. I fogli CSV sono note di interpretazione, non input JSON.
Scarica la revisione API compilata · Scarica la revisione API vuota
node backlink-api-cli.mjs backlink-api-example-it.json > backlink-api-records.csv
node backlink-api-cli.mjs backlink-api-example-it.json --json > backlink-api-projection.jsonRispetta il perimetro della proiezione
Sono accettati un’attività, un risultato, massimo 1.000 elementi e 512 KiB. I metadati selezionati della richiesta hanno un limite di 2.000 caratteri. Non tutti i campi vengono esportati: conserva il grezzo. Le date non diventano date di pubblicazione. Non si recuperano pagine, uniscono risultati paginati o autenticano account. Un risultato vuoto valido vale solo nel suo ambito. Pubblicazione attuale, accesso, indicizzazione e rendimento richiedono verifiche separate.