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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
target | Obbligatorio | Dominio obbligatorio senza https:// né www., per esempio example.com. |
location_code | Facoltativo | Codice numerico positivo del mercato di ricerca. Il Playground usa per impostazione predefinita 2840. |
location_name | Facoltativo | Nome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code. |
language_code | Facoltativo | Codice della lingua di ricerca, da 2 a 10 caratteri. Il Playground usa per impostazione predefinita en. |
language | Facoltativo | Nome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code. |
results_limit | Facoltativo | Massimo richiesto da 1 a 1.000 record di pagine indicizzate. Possono essere restituite meno righe. |
offset | Facoltativo | Numero 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.
- 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.
- Invia con POST il payload a /v1/seo/relevant-pages e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.
- Keyword Suggestions API
- Related Keywords API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors 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