v0.2.0-beta

OpenAPI 3.1.0

Pagine pertinenti

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operazioni

post/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live

Pagine pertinenti

Quali pagine di un sito target ottengono i suoi posizionamenti, ordinate per il traffico che portano. Paginazione con limit, offset e offset_token; usa il token oltre le prime pagine. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Usalo per trovare le pagine che vale la pena difendere o ampliare. Per le keyword dietro di esse usa post_dataforseo_labs_google_kw_for_site_live; per le pagine che ottengono link invece di posizionamenti, post_dataforseo_backlinks_domain_pages_summary_live.

Riferimento prezzi

Misurazione: costo della risposta comunicato.
Stima di riferimento per richiesta: USD 0.015.
Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo

application/json

Tipo: array (object | null)[]
- filters
  Tipo: array (object | null)[] | null
  
  array di parametri per il filtraggio dei risultati
  campo facoltativo
  è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
  tra le condizioni è necessario impostare un operatore logico and, or
  sono supportati i seguenti operatori:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in
  
  esempio:
  ["metrics.paid.count",">",0]
  
  [["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]]
  
  [[""metrics.organic.count",">",50"], "and", [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
  per ulteriori informazioni sui filtri, fare riferimento a Dataforseo Labs - Filters o a questa guida del Help Center
  
  Oggetto vuoto
- historical_serp_mode
  Tipo: string | null
  
  modalità di raccolta dati
  campo facoltativo
  è possibile usare questo campo per filtrare i risultati;
  tipi di filtro possibili:
  live — restituisce le metriche per le SERP in cui il target specificato ha attualmente risultati in classifica;
  lost — restituisce le metriche per le SERP in cui il target specificato aveva risultati in classifica in precedenza, ma non li aveva durante l'ultima verifica;
  all — restituisce le metriche per entrambi i tipi di SERP.
  valore predefinito: live
- ignore_synonyms
  Tipo: boolean | null
  
  ignora keyword molto simili
  campo facoltativo
  se impostato su true, vengono restituite solo le keyword principali, tutte le keyword molto simili vengono escluse;
  valore predefinito: false
- include_clickstream_data
  Tipo: boolean | null
  
  includi o escludi i dati delle metriche basate su clickstream nel risultato
  campo facoltativo
  se il parametro è impostato su true, nella risposta si ricevono i campi clickstream_etv, clickstream_gender_distribution e clickstream_age_distribution con i dati clickstream
  valore predefinito: false
  con questo parametro abilitato viene addebitato il doppio del prezzo per la richiesta
  
  scopri di più su come vengono calcolate le metriche basate su clickstream in questo articolo del Help Center
- item_types
  Tipo: array string[] | null
  
  mostra i risultati per tipo di elemento
  campo facoltativo
  indica il tipo di risultati di ricerca inclusi nella risposta
  
  Nota: se l'array item_types contiene tipi di elemento diversi da organic, i risultati vengono ordinati in base al primo tipo di elemento nell'array; non è possibile ordinare o filtrare i risultati per i tipi di risultato di ricerca non inclusi nella risposta;
  
  valori possibili:
  ["organic", "paid", "featured_snippet", "local_pack"]
  valore predefinito:
  ["organic", "paid"]
- language_code
  Tipo: string | null
  
  codice della lingua
  campo facoltativo
  se si usa questo campo, non è necessario specificare language_name
  l'elenco delle lingue disponibili con language_code si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ignorare questo campo per ottenere i risultati per tutte le lingue disponibili
  esempio:
  en
- language_name
  Tipo: string | null
  
  nome completo della lingua
  campo facoltativo
  se si usa questo campo, non è necessario specificare language_code
  l'elenco delle lingue disponibili con language_name si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ignorare questo campo per ottenere i risultati per tutte le lingue disponibili
  esempio:
  English
- limit
  Tipo: integer | null
  
  numero massimo di pagine restituite
  campo facoltativo
  valore predefinito: 100
  valore massimo: 1000
- location_code
  Tipo: integer | null
  
  codice della località
  campo facoltativo
  se si usa questo campo, non è necessario specificare location_name
  l'elenco delle località disponibili con location_code si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ignorare questo campo per ottenere i risultati per tutte le località disponibili
  esempio:
  2840
- location_name
  Tipo: string | null
  
  nome completo della località
  campo facoltativo
  se si usa questo campo, non è necessario specificare location_code
  l'elenco delle località disponibili con location_name si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ignorare questo campo per ottenere i risultati per tutte le località disponibili
  esempio:
  United Kingdom
- offset
  Tipo: integer | null
  
  offset nell'array dei risultati delle pagine restituite
  campo facoltativo
  valore predefinito: 0
  se si specifica il valore 10, le prime dieci pagine nell'array dei risultati vengono omesse e i dati vengono forniti per le pagine successive
- order_by
  Tipo: array string[] | null
  
  regole di ordinamento dei risultati
  campo facoltativo
  è possibile usare gli stessi valori dell'array filters per ordinare i risultati
  tipi di ordinamento possibili:
  asc – i risultati vengono ordinati in ordine crescente
  desc – i risultati vengono ordinati in ordine decrescente
  il tipo di ordinamento si specifica con una virgola
  esempio:
  ["metrics.paid.etv,asc"]
  Nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
  per separare più regole di ordinamento usare una virgola
  esempio:
  ["metrics.organic.etv,desc","metrics.paid.count,asc"]
  
  regola predefinita:
  ["metrics.organic.count,desc"]
  Nota: se l'array item_types contiene tipi di elemento diversi da organic, i risultati vengono ordinati in base al primo tipo di elemento nell'array
- tag
  Tipo: string | null
  
  identificatore dell'attività definito dall'utente
  campo facoltativo
  il limite di caratteri è 255
  puoi usare questo parametro per identificare l'attività e associarla al risultato
  il valore tag specificato si trova nell'oggetto data della risposta
- target
  Tipo: string
  
  dominio
  campo obbligatorio
  il nome del dominio del sito web di destinazione
  il dominio va specificato senza https:// e www.

Risposte

200
Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelevantPagesLiveResponseInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

status_code
Tipo: integer | null

codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

tasks
Tipo: array (object | null)[] | null

array di attività

Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelevantPagesLiveTaskInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

data
Tipo: object | null

Contiene gli stessi parametri specificati nella richiesta POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

path
Tipo: array (string | null)[] | null

Percorso URL

result
Tipo: array (object | null)[] | null

array di risultati

items
Tipo: array (object | null)[] | null

pagine pertinenti e dati correlati

metrics
Tipo: object | null

metriche di ranking e di traffico per la pagina pertinente

propertyName
Tipo: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
clickstream_age_distribution
Tipo: object | null

distribuzione delle metriche basate sul clickstream per età
per ottenere risultati per questo campo, il parametro include_clickstream_data deve essere impostato su true
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

clickstream_etv
Tipo: number | null Formato: double

volume di traffico stimato basato sui dati clickstream
calcolato come il prodotto del click-through rate e dei valori di volume di ricerca clickstream di tutte le keyword per cui il dominio si posiziona
per ottenere risultati per questo campo, il parametro include_clickstream_data deve essere impostato su true
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center

clickstream_gender_distribution
Tipo: object | null

distribuzione delle metriche stimate basate sul clickstream per genere
per ottenere risultati per questo campo, il parametro include_clickstream_data deve essere impostato su true
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

count
Tipo: integer | null Formato: int64

numero totale di SERP organici che contengono il dominio o sottodominio

estimated_paid_traffic_cost
Tipo: number | null

costo stimato per convertire il traffico organico in traffico a pagamento
rappresenta il costo mensile stimato (USD) per la pubblicità di tutte le keyword nella categoria per cui il dominio o sottodominio si posiziona
la metrica viene calcolata come il prodotto dei valori organici etv e dei valori a pagamento cpc e indica il costo per generare il volume stimato di traffico organico mensile tramite pubblicità PPC su Google Search
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center

etv
Tipo: number | null

volume di traffico stimato
traffico organico mensile stimato verso il dominio o sottodominio
calcolato come il prodotto dei valori CTR (click-through rate) e volume di ricerca di tutte le keyword nella categoria per cui il dominio o sottodominio si posiziona
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center

is_down
Tipo: integer | null

posizione diminuita
indica quanti elementi posizionati del target indicato sono diminuiti

is_lost
Tipo: integer | null

elementi posizionati persi
indica quanti elementi posizionati del target indicato erano precedentemente presenti nei SERP ma non sono stati trovati durante l'ultimo controllo

is_new
Tipo: integer | null

numero di nuovi elementi posizionati
indica quanti nuovi elementi posizionati sono stati trovati per il target indicato

is_up
Tipo: integer | null

posizione aumentata
indica quanti elementi posizionati del target indicato sono aumentati

pos_1
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 1

pos_11_20
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 11-20

pos_2_3
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 2-3

pos_21_30
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 21-30

pos_31_40
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 31-40

pos_4_10
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 4-10

pos_41_50
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 41-50

pos_51_60
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 51-60

pos_61_70
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 61-70

pos_71_80
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 71-80

pos_81_90
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 81-90

pos_91_100
Tipo: integer | null

numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 91-100

page_address
Tipo: string | null

URL assoluto della pagina pertinente

se_type
Tipo: string | null

tipo di motore di ricerca

items_count
Tipo: integer | null Formato: int64

il numero di risultati restituiti nell'array items

language_code
Tipo: string | null

codice lingua in un array POST
se non ci sono dati, il valore è null

location_code
Tipo: integer | null

codice località in un array POST
se non ci sono dati, il valore è null

se_type
Tipo: string | null

tipo di motore di ricerca

target
Tipo: string | null

dominio di destinazione in un array POST

total_count
Tipo: integer | null Formato: int64

quantità totale di risultati nel nostro database pertinenti alla tua richiesta

result_count
Tipo: integer | null Formato: int64

Numero di elementi nell'array dei risultati

status_code
Tipo: integer | null

codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

time
Tipo: string | null

Tempo di esecuzione in secondi

tasks_count
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks

tasks_error
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks restituite con un errore

time
Tipo: string | null

tempo di esecuzione totale, secondi

version
Tipo: string | null

La versione corrente dell'API
application/json
400

Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
401

È richiesta una chiave API Felo valida.
402

Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
403

L'account non è autorizzato a eseguire questa operazione.
429

È stato raggiunto un limite di richieste o di spesa.
502

Il servizio non è riuscito a completare la richiesta.
503

L'API o il servizio di fatturazione è temporaneamente non disponibile.
504

Si è verificato un timeout durante l'elaborazione della richiesta.
default

Risposta di errore; le risposte passthrough upstream possono usare formati del provider

application/json

post/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "amazon.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        0
      ]
    ],
    "limit": 3
  }
]'

Mostra schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "page_address": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Pagine pertinenti

AutenticazioneRequired

DataForSEO

Pagine pertinenti

Riferimento prezzi