seo/
relevant-pages

Elenca le pagine indicizzate di un dominio, con URL delle pagine, distribuzioni del posizionamento, traffico di ricerca modellato e contesto dei costi della ricerca a pagamento in record normalizzati.

Relevant Pages API

Visibilità delle pagine
Distribuzione del posizionamento
Stime del traffico
0,15 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Relevant Pages

Le pagine rilevanti sono URL indicizzati con visibilità di ricerca organica o a pagamento misurabile, con conteggi di parole chiave, fasce di posizione, traffico modellato, stime dei costi e segnali di variazione. Queste misurazioni a livello di pagina supportano gli inventari della visibilità, il confronto dell’impronta, la revisione del valore del traffico e l’analisi di istantanee ripetute.

Funzionalità della Relevant Pages API

  • Inventario delle pagine a livello di dominioRestituisce gli URL assoluti delle pagine di un dominio che hanno una rilevanza organica o a pagamento misurabile nell’indice di ricerca selezionato.
  • Distribuzione del posizionamento organicoConserva i conteggi delle parole chiave organiche per fascia di posizione, insieme ai conteggi di posizionamenti nuovi, in crescita, in calo e persi, quando esposti.
  • Impronta della ricerca a pagamentoEspone, per ogni pagina, i conteggi disponibili delle parole chiave a pagamento, gli intervalli di posizione, il traffico modellato e il costo stimato del traffico a pagamento.
  • Oggetti completi delle metriche di paginaMantiene in extra le misurazioni annidate organiche, a pagamento e le altre misurazioni variabili a livello di pagina, normalizzando l’URL della pagina per un’identificazione stabile.

Parametri della Relevant Pages API

ParametriObbligatorioDescrizione
targetObbligatorioDominio obbligatorio senza https:// né www., per esempio example.com.
location_codeFacoltativoCodice numerico positivo del mercato di ricerca. Il Playground usa per impostazione predefinita 2840.
location_nameFacoltativoNome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code.
language_codeFacoltativoCodice della lingua di ricerca, da 2 a 10 caratteri. Il Playground usa per impostazione predefinita en.
languageFacoltativoNome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code.
results_limitFacoltativoMassimo richiesto da 1 a 1.000 record di pagine indicizzate. Possono essere restituite meno righe.
offsetFacoltativoNumero a base zero di righe della fonte da saltare prima di raccogliere la finestra di risultati richiesta.

Come usare la Relevant Pages API

Invia un dominio formattato correttamente con controlli di mercato e una finestra della fonte limitata, poi leggi ogni pagina rilevante dall’attività asincrona completata.

  1. Scegli un dominio senza https:// né www., un location_code, un language_code, un results_limit da 1 a 1.000 e un offset pari o superiore a 0.
  2. Invia con POST il payload a /v1/seo/relevant-pages e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
  4. Leggi data.results.items, poi richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/seo/relevant-pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Relevant Pages API

  • Inventario delle pagine visibili nella ricerca: Usa gli URL delle pagine restituite per costruire un inventario del dominio limitato alle pagine con rilevanza di ricerca indicizzata misurabile.
  • Confronto dell’impronta organica: Confronta i conteggi delle parole chiave organiche, le fasce di posizionamento e i campi di variazione per capire come si distribuisce la visibilità tra le pagine.
  • Revisione delle pagine nella ricerca a pagamento: Usa i conteggi delle parole chiave a pagamento, gli intervalli di posizione, il traffico modellato e il costo stimato per confrontare l’impronta a pagamento delle pagine restituite.
  • Istantanee della visibilità delle pagine: Salva record ripetuti per page_address e mercato per confrontare distribuzioni del posizionamento e traffico modellato tra momenti di raccolta diversi.

Consigli degli esperti per la Relevant Pages API

  • Rimuovi https:// e www. da target prima dell’invio, perché questo endpoint si aspetta un dominio e non l’URL completo di una pagina.
  • Usa url restituito come identificatore della pagina; text è lo stesso URL di riserva e non contiene il contenuto del corpo della pagina.
  • Mantieni fissi target, location_code, language_code, results_limit e offset quando confronti finestre di risultati ripetute.
  • Considera offset come un conteggio di righe della fonte e non come un numero di pagina, e conservalo separatamente dal next_cursor dei risultati dell’attività.
  • Leggi le misurazioni organiche e a pagamento da extra.metrics e metti in conto che gruppi di metriche annidati o singoli campi possano mancare.
  • Interpreta etv ed estimated_paid_traffic_cost come stime di ricerca modellate e non come analisi private o ricavi osservati.

Oltre alla Relevant Pages 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.
  • Keyword Search Volume API — Misura parole chiave note con volume di ricerca, CPC, concorrenza a pagamento e cronologia mensile delle ricerche, se disponibili.
  • Keywords for Site API — Genera parole chiave rilevanti per un sito web con misurazioni della domanda, cronologia mensile, contesto del mercato e righe di origine complete, se disponibili.
  • Ranked Keywords API — Trova le parole chiave per cui si posizionano un dominio, un sottodominio o una pagina, con URL corrispondenti, posizioni, misurazioni di ricerca, intento ed elementi di origine completi.

Esplora altre piattaforme

Combina i dati di SEO con i dati pubblici delle altre piattaforme social supportate.

Relevant Pages API — FAQ

Relevant Pages API è un’interfaccia programmatica per trovare le pagine indicizzate con rilevanza di ricerca misurabile per un dominio, senza il suo protocollo né www. Restituisce URL delle pagine, distribuzioni del posizionamento organico e a pagamento, traffico modellato, stime dei costi, conteggi delle variazioni e righe complete della fonte.

Invia un solo dominio, come example.com, senza https:// e senza www. Non inviare l’URL completo di una pagina per questo inventario di domini a livello di pagina.

No. Restituisce le pagine note all’indice di ricerca con rilevanza organica o a pagamento misurabile, quindi le pagine non indicizzate e quelle senza visibilità misurabile possono non comparire.

La riga della fonte può includere conteggi delle parole chiave organiche e a pagamento, fasce di posizione, traffico modellato, costo stimato del traffico a pagamento e conteggi delle variazioni di posizionamento. Questi valori annidati restano in extra.metrics e non nell’oggetto metrics normalizzato di primo livello.

No. I valori di etv e del costo del traffico sono stime di ricerca modellate, non analisi private, visite osservate o misurazioni dei ricavi.

Ogni pagina restituita costa 0,15 crediti SocQ. Un insieme di risultati vuoto non comporta addebiti sui risultati e results_limit fornisce la stima prima della richiesta, non un conteggio finale garantito.