Backlinks
Un backlink è un singolo link da una pagina di un altro sito verso un dominio o una pagina, descritto dalla pagina di origine e dal suo titolo, dall’URL di destinazione, dall’anchor text, dallo stato dofollow e dagli attributi rel, dai punteggi di autorità del link, della pagina e del dominio, da uno spam score, dalla posizione nella pagina e dalle date di prima e ultima rilevazione. Elencati uno per uno, questi link mostrano quali pagine e quali anchor danno autorità a un sito, e alimentano gli audit degli anchor text, l’analisi dei link dei concorrenti, le liste per l’outreach e il monitoraggio dei link nuovi, persi e rotti.
Funzionalità della Backlinks API
- Ogni link, dai più fortiUn dominio, un sottodominio o un URL di pagina restituisce i suoi singoli backlink ordinati dal più forte in giù, da 1 a 1.000 per richiesta tramite results_limit.
- Entrambe le estremità di ogni linksource_url, source_domain e source_title identificano la pagina che linka, language ne indica il codice lingua e target_url mostra esattamente quale pagina del target riceve il link.
- Anchor, markup e posizioneanchor contiene il testo del link, link_type distingue un anchor da un link immagine, redirect o canonical, is_dofollow e attributes riportano i valori rel, e semantic_location colloca il link in un articolo, nella navigazione o nel footer.
- Autorità su tre livellirank valuta il link stesso, source_page_rank e source_domain_rank la pagina e il sito in cui si trova, tutti da 0 a 1.000, con spam_score da 0 a 100 accanto.
- Flag e date del ciclo di vita dei linkis_new, is_lost e is_broken segnalano i link trovati dalla scansione precedente, quelli rimossi dalla loro pagina e quelli che puntano a pagine non più raggiungibili, con first_seen_at e last_seen_at a fare da cornice.
Parametri della Backlinks API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
target | Obbligatorio | Dominio, sottodominio o URL completo di pagina di cui vuoi i backlink, come notion.so o https://example.com/blog/post. |
results_limit | Facoltativo | Numero di backlink da restituire, un intero da 1 a 1.000; il valore predefinito è 100. I link più forti arrivano per primi. |
Come usare la Backlinks API
Invia un target e il numero di link che ti servono, poi scorri le righe dei link.
- Invia con POST {"target": "notion.so", "results_limit": 100} a /v1/seo/backlinks.
- Interroga GET /v1/tasks/{task_id} con il task_id restituito finché status non diventa succeeded.
- Leggi i link da results.items e continua a richiedere con results.next_cursor finché has_more è true, fino a caricare tutti i link.
curl -X POST "https://api.socq.ai/v1/seo/backlinks" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","results_limit":100}'
# 10 credits per request plus 0.02 per backlink returned.Casi d’uso della Backlinks API
- Audit degli anchor text: Raggruppa le righe per anchor per vedere quanta parte del profilo usa nomi di brand, URL nudi o frasi chiave, e controlla is_dofollow su quelli ricchi di parole chiave.
- Estrarre i link più forti di un concorrente: Invia il dominio di un concorrente e prendi le prime righe per rank, con source_domain e source_title, come rosa di testate a cui proporsi.
- Trovare le pagine che attirano link: Conta le righe per target_url sul tuo dominio per scoprire quali articoli, strumenti o landing page ottengono backlink e meritano aggiornamenti o link interni.
- Monitorare link nuovi e persi: Filtra is_new e is_lost, con last_seen_at, per segnalare i link guadagnati e persi da un sito e ricontattare chi ha rimosso un link.
- Reindirizzare le destinazioni dei link rotti: Le righe con is_broken attivo elencano i valori di target_url che ora non funzionano, così ogni pagina morta può essere reindirizzata e i suoi link in entrata recuperati.
Consigli degli esperti per la Backlinks API
- Usa id come chiave quando salvi i link tra un’esecuzione e l’altra, perché è costruito da pagina che linka, pagina linkata e anchor e resta uguale per lo stesso link.
- Aspettati più righe dallo stesso source_domain, perché ogni link è elencato separatamente; raggruppa per source_domain, oppure passa a Referring Domains API, quando ti serve una riga per sito.
- Escludi le righe con is_lost uguale a true prima di contare i link attivi, perché i link scomparsi dalla loro pagina possono essere ancora elencati con quel flag.
- Tieni results_limit alla profondità che esaminerai davvero: l’elenco parte dai link più forti, quindi un limite più basso taglia quelli più deboli e il costo per link.
API correlate
Oltre alla Backlinks API, usa queste API quando ti serve un altro tipo di dati pubblici di SEO.
- Google Organic SERP API — Recupera una pagina di risultati Google in tempo reale per query e mercato con destinazioni, posizioni, tipi di elemento e dettagli completi dei risultati normalizzati.
- Keyword Difficulty API — Confronta la difficoltà di posizionamento organico per un gruppo di parole chiave inviato, restituendo ogni parola chiave disponibile con il suo punteggio normalizzato.
- Keyword Overview API — Arricchisce un gruppo di parole chiave inviato con domanda, concorrenza a pagamento, difficoltà, ricerche mensili e contesto dell’intento, se disponibili.
- Backlinks Summary API — Riassume in una sola riga il profilo di link di un dominio, sottodominio o pagina con rank di autorità, totali di backlink e domini di riferimento, spam score e ripartizione delle fonti dei link.
- Referring Domains API — Elenca i domini che linkano a un sito o a una pagina, uno per riga, con rank di autorità, conteggi di backlink e pagine, spam score e date di inizio e fine dei link.
- Backlink Competitors API — Trova i domini che condividono più domini di riferimento con un sito o una pagina, ordinati per sovrapposizione e con il loro rank di autorità.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API