Panoramica
Una risposta API descrive osservazioni con ambito, raggruppamento e cronologia specifici. Non elenca tutti i link del Web. Questa guida usa l'importatore locale e un esempio immaginario shop.example. L'importatore è stato testato offline; non sono state eseguite richieste a pagamento o misurazioni della copertura del fornitore.
Scegli il target e conserva la richiesta
L'endpoint backlinks/backlinks/live di DataForSEO supporta domini, sottodomini e pagine. Controlla il formato aggiornato e scegli l'ambito adatto. Una richiesta per una pagina non rappresenta un rapporto completo del dominio. Conserva i parametri inviati insieme alla risposta originale per rendere verificabile la richiesta.
Il raggruppamento cambia il significato delle righe. I modi documentati includono as_is, one_per_domain e one_per_anchor. Non confrontare direttamente rapporti raggruppati diversamente. La documentazione descrive link unici per pagina di provenienza e links_count per quelli ripetuti. Una riga non rappresenta necessariamente ogni elemento di collegamento HTML della pagina. La definizione del fornitore prevale sull'etichetta del foglio di calcolo.
Pianifica accesso e costi prima della raccolta
Le richieste all'endpoint live sono a pagamento. Ottieni autorizzazione, verifica i prezzi attuali, definisci un limite fermo di spesa e memorizza le risposte utili. Un limite di righe non basta se un processo può inviare molte richieste. Conserva le credenziali sul server e non copiarle in schermate, esportazioni condivise o strumenti pubblici nel browser.
L'esercizio elabora localmente una risposta fornita e non richiede credenziali. Non verifica accesso, disponibilità live, autorizzazioni dell'account o completezza dell'indice. Per una raccolta reale registra data, target, filtri, raggruppamento e paginazione e conserva privatamente il file originale.
Controlla stato e ambito prima delle righe
Controlla sia la struttura generale sia lo stato di ogni attività. Un errore di autenticazione o attività non dimostra che il target abbia zero backlink. L'importatore rifiuta risposte fallite o incompatibili invece di creare un rapporto vuoto riuscito. Correggi prima la causa dell'errore.
Confronta totale e record restituiti. L'esempio immaginario indica 9 e restituisce quattro record: la proiezione è esplicitamente parziale. Sono valori dimostrativi, non statistiche reali. La differenza non significa cinque link persi o interrotti. Ulteriore raccolta richiede un piano autorizzato e limitato con impostazioni coerenti.
Riproduci l'esempio locale
Usa l'esempio fornito o il JSON scaricabile. Verifica target shop.example, modo as_is, quattro record e indicazione di risultato parziale. Confronta i dettagli con il JSON originale prima di scaricare il CSV proiettato. È disponibile anche una versione JavaScript scaricabile per uso offline. Conserva la risposta grezza separatamente: il CSV non mantiene ogni campo del fornitore.
I valori mancanti restano sconosciuti senza diventare zero o false. Un anchor mancante è diverso da uno vuoto; il campo dofollow del fornitore è separato dall'elenco degli attributi. Una riga include sponsored e nofollow, un'altra un'osservazione di perdita, un'altra campi mancanti. Questi casi aiutano a rilevare cambiamenti silenziosi di significato nei rapporti successivi.
Verifica risultati e documenta i limiti
La suite mirata dell'importatore ha superato 21 test il 28 ottobre 2026. Copre esempi tradotti, risposte fallite, limiti di dimensioni e quantità, valori sconosciuti, URL errati ed esportazione offline. Verifica i casi dell'importatore testati, non copertura, aggiornamento o precisione del fornitore.
Distingui prima e ultima osservazione dalle date reali di creazione o rimozione. Un indicatore di perdita non prova una rimozione permanente e uno stato HTTP salvato potrebbe non essere attuale. Un controllo separato e consentito della pagina sorgente può esaminare il presente. Data separatamente osservazioni del fornitore, controlli propri e conclusioni. Il numero di backlink non dimostra posizioni o traffico.