Felo API PlatformFelo API Platform
Tutti gli endpoint di DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Panoramica del ranking del dominio

Server:https://openapi.felo.ai
Librerie client

DataForSEO

​

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

Panoramica del ranking del dominio

​

L'impronta di ricerca di un dominio: numero di keyword organiche e a pagamento, traffico stimato e valore del traffico, per location_code. Restituisce se_type, target, total_count, items_count e items. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Per gli stessi numeri nel tempo usare post_dataforseo_labs_google_historical_rank_live; per molti domini insieme, post_dataforseo_labs_google_bulk_traffic_estimation_live.

Riferimento prezzi

  • Misurazione: costo della risposta riportato.
  • Stima di riferimento per richiesta: USD 0.0121.
  • Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.

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

Corpo
application/json
  • Tipo: array (object | null)[]
    • ignore_synonyms
      Tipo: boolean | null

      ignora keyword molto simili
      campo facoltativo
      se impostato su true, tutte le keyword molto simili vengono escluse dai calcoli di posizionamento e traffico, i risultati si basano sui dati delle keyword principali dei gruppi di sinonimi
      valore predefinito: false

    • 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 risultati restituiti per dominio
      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 degli elementi restituiti
      campo facoltativo
      valore predefinito: 0
      se si specifica il valore 10, i primi dieci items nell'array dei risultati vengono saltati e i dati vengono forniti per gli elementi successivi

    • 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_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
        • 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

            contiene dati di ranking e di traffico

            • language_code
              Tipo: string | null

              codice lingua in un array POST

            • location_code
              Tipo: integer | null

              codice posizione in un array POST

            • metrics
              Tipo: object | null

              dati di ranking relativi al dominio specificato

              • 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

            • 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

          • location_code
            Tipo: integer | null

            codice posizione in un array POST

          • 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
Request Example for post/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840
  }
]'
{
  "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,
              "location_code": null,
              "language_code": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}
Domain Rank Overview