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

Panoramica delle keyword

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

Panoramica delle keyword

​

Tutto ciò che Labs sa su un elenco di keywords in una sola chiamata: volume, difficoltà, intento, concorrenza e le funzionalità SERP che attivano. Restituisce se_type, location_code, language_code, items_count e items. Questo endpoint non ha un parametro limit, ma viene fatturato per chiamata anziché per elemento: inviare quindi l'intera lista in una sola volta. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Partire da qui quando si hanno keyword; post_dataforseo_labs_google_keyword_ideas_live è dove andare quando se ne vogliono altre.

Riferimento prezzi

  • Misurazione: costo della risposta riportato.
  • Stima di riferimento per richiesta: USD 0.0254.
  • 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)[]
    • 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_keyword_info, keyword_info_normalized_with_clickstream e keyword_info_normalized_with_bing
      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

    • include_serp_info
      Tipo: boolean | null

      includi i dati della SERP per ogni keyword
      campo facoltativo
      se impostato su true, restituiamo un array serp_info contenente i dati SERP (numero di risultati di ricerca, URL pertinente e funzionalità SERP) per ogni keyword nella risposta
      valore predefinito: false

    • keywords
      Tipo: array string[]

      keyword
      campo obbligatorio
      numero massimo di keyword specificabili: 700
      numero massimo di caratteri per ogni keyword: 80
      numero massimo di parole per ogni frase keyword: 10
      le keyword specificate vengono convertite in minuscolo, i dati vengono forniti in un array separato

      nota: se alcune delle keyword specificate in questo array sono assenti dai risultati ricevuti, il nostro database non contiene tali keyword e non può restituire dati al riguardo
      per le keyword assenti dai risultati non viene addebitato alcun costo

      scopri di più su regole e limiti dei campi keyword e keywords nelle API DataForSEO in questo articolo del Help Center

    • language_code
      Tipo: string | null

      codice della lingua
      campo obbligatorio se non si specifica language_name
      Nota: è necessario specificare language_name oppure language_code
      l'elenco delle località disponibili con language_code si ottiene con una richiesta separata a
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      esempio:
      en

    • language_name
      Tipo: string

      nome completo della lingua
      campo obbligatorio se non si specifica language_code
      Nota: è necessario specificare language_name oppure language_code
      l'elenco delle località disponibili con language_name si ottiene con una richiesta separata a
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      esempio:
      English

    • location_code
      Tipo: integer

      codice della località
      campo obbligatorio se non si specifica location_name
      Nota: è necessario specificare location_name oppure location_code
      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
      esempio:
      2840

    • location_name
      Tipo: string

      nome completo della località
      campo obbligatorio se non si specifica location_code
      Nota: è necessario specificare location_name oppure 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
      esempio:
      United Kingdom

    • 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

Risposte
  • 200
    Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
        • 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 keyword e dati correlati

            • avg_backlinks_info
              Tipo: object | null · Response36Afe1097B20_AvgBacklinksInfo

              dati backlink per la keyword restituita
              questo oggetto fornisce il numero medio di backlink, pagine e domini di riferimento, nonché i valori di ranking medi tra i primi 10 siti web posizionati organicamente per la keyword

              • backlinks
                Tipo: number | null

                numero medio di backlink

              • dofollow
                Tipo: number | null

                numero medio di link dofollow

              • last_updated_time
                Tipo: string | null

                data e ora di aggiornamento dei dati delle keyword
                nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                esempio:
                2019-11-15 12:57:46 +00:00

              • main_domain_rank
                Tipo: number | null

                posizione media del dominio principale
                scopri di più sulla metrica e sulla sua formula di calcolo in questo articolo del centro assistenza

              • rank
                Tipo: number | null

                rank medio
                scopri di più su questa metrica e sulla sua formula di calcolo in questo articolo del Help Center

              • referring_domains
                Tipo: number | null

                numero medio di domini di riferimento

              • referring_main_domains
                Tipo: number | null

                numero medio di domini principali di riferimento

              • referring_pages
                Tipo: number | null

                numero medio di pagine di riferimento

              • se_type
                Tipo: string | null

                tipo di motore di ricerca

            • clickstream_keyword_info
              Tipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              dati clickstream per la keyword restituita
              per recuperare i risultati per questo campo, il parametro include_clickstream_data deve essere impostato su true

              • age_distribution
                Tipo: object | null

                distribuzione delle metriche basate su clickstream per età
                scopri di più su come viene calcolata questa metrica in questo articolo del Help Center

                • propertyName
                  Tipo: integer | null Formato: int64

                  Signed 64-bit integers (long type).

              • gender_distribution
                Tipo: object | null

                distribuzione delle metriche stimate basate su clickstream per sesso
                scopri di più su come viene calcolata questa metrica in questo articolo del Help Center

                • propertyName
                  Tipo: integer | null Formato: int64

                  Signed 64-bit integers (long type).

              • last_updated_time
                Tipo: string | null

                data e ora di aggiornamento dei dati delle keyword
                nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                esempio:
                2019-11-15 12:57:46 +00:00

              • monthly_searches
                Tipo: array (object | null)[] | null

                ricerche mensili
                rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate

                • month
                  Tipo: integer | null

                  Mese

                • search_volume
                  Tipo: integer | null

                  tasso medio mensile di volume di ricerca

                • year
                  Tipo: integer | null

                  Anno

              • search_volume
                Tipo: integer | null Formato: int64

                volume di ricerca medio mensile
                rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com

            • keyword
              Tipo: string | null

              keyword
              la keyword viene restituita con %## decodificato (il carattere più '+' viene decodificato in uno spazio)

            • keyword_info
              Tipo: object | null · Response36Afe1097B20_KeywordInfo

              dati delle keyword per la keyword restituita

              • categories
                Tipo: array integer[] | null

                categorie di prodotti e servizi
                puoi scaricare l'elenco completo delle categorie possibili

              • competition
                Tipo: number | null

                concorrenza
                indica l'intensità relativa della concorrenza per la keyword in questione. Il valore si basa sui dati di Google Ads e può essere compreso tra 0 e 1 (inclusi)

              • competition_level
                Tipo: string | null

                livello di concorrenza
                indica il livello relativo di concorrenza per la keyword in questione, esclusivamente nella SERP a pagamento;
                valori possibili: LOW, MEDIUM, HIGH
                se il livello di concorrenza non è noto, il valore è null;
                scopri di più sulla metrica in questo articolo dell'Help Center

              • cpc
                Tipo: number | null

                costo per clic
                indica il costo medio per clic (USD) storicamente pagato per la keyword

              • high_top_of_page_bid
                Tipo: number | null

                offerta massima per mostrare l'annuncio in cima alla prima pagina
                indica il valore che supera di circa l'80% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
                il valore può variare in base alla località specificata in una richiesta POST

              • last_updated_time
                Tipo: string | null

                data e ora di aggiornamento dei dati delle keyword
                nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                esempio:
                2019-11-15 12:57:46 +00:00

              • low_top_of_page_bid
                Tipo: number | null

                offerta minima per mostrare l'annuncio in cima alla prima pagina
                indica il valore che supera di circa il 20% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
                il valore può variare in base alla località specificata in una richiesta POST

              • monthly_searches
                Tipo: array (object | null)[] | null

                ricerche mensili
                rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate

                • month
                  Tipo: integer | null

                  Mese

                • search_volume
                  Tipo: integer | null

                  tasso medio mensile di volume di ricerca

                • year
                  Tipo: integer | null

                  Anno

              • se_type
                Tipo: string | null

                tipo di motore di ricerca

              • search_volume
                Tipo: integer | null Formato: int64

                volume di ricerca medio mensile
                rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com

              • search_volume_trend
                Tipo: object | null · Response36Afe1097B20_SearchVolumeTrend

                variazioni della tendenza di ricerca
                indica la variazione percentuale del volume di ricerca rispetto al periodo precedente

                • monthly
                  Tipo: integer | null

                  variazione percentuale del volume di ricerca rispetto al mese precedente

                • quarterly
                  Tipo: integer | null

                  variazione percentuale del volume di ricerca rispetto al trimestre precedente

                • yearly
                  Tipo: integer | null

                  variazione percentuale del volume di ricerca rispetto all'anno precedente

            • keyword_info_normalized_with_bing
              Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              contiene il volume di ricerca della keyword normalizzato sul volume di ricerca Bing

              • is_normalized
                Tipo: boolean | null

                i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing

              • last_updated_time
                Tipo: string | null

                data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00

              • monthly_searches
                Tipo: array (object | null)[] | null

                tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno

                • month
                  Tipo: integer | null

                  Mese

                • search_volume
                  Tipo: integer | null

                  tasso medio mensile di volume di ricerca

                • year
                  Tipo: integer | null

                  Anno

              • search_volume
                Tipo: integer | null

                tasso attuale di volume di ricerca di una keyword

            • keyword_info_normalized_with_clickstream
              Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              contiene il volume di ricerca della keyword normalizzato sui dati clickstream

              • is_normalized
                Tipo: boolean | null

                i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing

              • last_updated_time
                Tipo: string | null

                data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00

              • monthly_searches
                Tipo: array (object | null)[] | null

                tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno

                • month
                  Tipo: integer | null

                  Mese

                • search_volume
                  Tipo: integer | null

                  tasso medio mensile di volume di ricerca

                • year
                  Tipo: integer | null

                  Anno

              • search_volume
                Tipo: integer | null

                tasso attuale di volume di ricerca di una keyword

            • keyword_properties
              Tipo: object | null · Response36Afe1097B20_KeywordProperties

              informazioni aggiuntive sulla keyword

              • core_keyword
                Tipo: string | null

                keyword principale in un gruppo
                contiene la keyword principale in un gruppo determinata dall'algoritmo di clustering dei sinonimi
                se il valore è null, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi di keyword

              • detected_language
                Tipo: string | null

                lingua rilevata della keyword
                indica la lingua della keyword identificata dal nostro sistema

              • is_another_language
                Tipo: boolean | null

                la lingua rilevata della keyword differisce dalla lingua impostata
                se il valore è true, la lingua specificata nella richiesta non corrisponde a quella determinata dal nostro sistema per una keyword

              • keyword_difficulty
                Tipo: integer | null

                difficoltà di posizionamento nei primi 10 risultati organici per una keyword
                indica la probabilità di entrare nei primi 10 risultati organici per una keyword, su una scala logaritmica da 0 a 100;
                calcolata, tra l'altro, analizzando i profili di link delle prime 10 pagine nella SERP;
                scopri di più sulla metrica in questa guida dell'Help Center

              • se_type
                Tipo: string | null

                tipo di motore di ricerca

              • synonym_clustering_algorithm
                Tipo: string | null

                l'algoritmo utilizzato per identificare i sinonimi
                valori possibili:
                keyword_metrics - indica l'algoritmo basato sui parametri di keyword_info
                text_processing - indica l'algoritmo basato sul testo
                se il valore è null, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi di keyword

              • words_count
                Tipo: integer | null Formato: int64

                numero di parole nella keyword
                indica da quante parole è composta la keyword

            • 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

            • search_intent_info
              Tipo: object | null · Response36Afe1097B20_SearchIntentInfo

              informazioni sull'intento di ricerca per la keyword restituita
              scopri di più sull'intento di ricerca in questo articolo dell'Help Center

              • foreign_intent
                Tipo: array (string | null)[] | null

                intenti di ricerca supplementari
                valori possibili: informational, navigational, commercial, transactional

              • last_updated_time
                Tipo: string | null

                data e ora di aggiornamento dei dati delle keyword
                nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                esempio:
                2019-11-15 12:57:46 +00:00

              • main_intent
                Tipo: string | null

                intento di ricerca principale
                valori possibili: informational, navigational, commercial, transactional

              • se_type
                Tipo: string | null

                tipo di motore di ricerca

            • search_partners
              Tipo: boolean | null

              indica i dati per Google e i siti partner
              se true, i risultati vengono restituiti per reti di proprietà, gestite e syndicated su Google e sui siti partner che ospitano la ricerca Google;
              se false, i risultati vengono restituiti solo per i siti di ricerca Google

            • serp_info
              Tipo: object | null · Response36Afe1097B20_SerpInfo

              dati SERP
              il valore sarà null se non hai impostato il campo include_serp_info su true nell'array POST o se non ci sono dati SERP per questa keyword nel nostro database

              • check_url
                Tipo: string | null

                URL diretto ai risultati del motore di ricerca
                puoi usarlo per verificare che abbiamo fornito risultati accurati

              • last_updated_time
                Tipo: string | null

                data e ora di aggiornamento dei dati delle keyword
                nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                esempio:
                2019-11-15 12:57:46 +00:00

              • previous_updated_time
                Tipo: string | null

                data e ora precedenti all'ultimo aggiornamento dei dati SERP
                nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                esempio:
                2019-10-15 12:57:46 +00:00

              • se_results_count
                Tipo: integer | null Formato: int64

                numero di risultati di ricerca per la keyword restituita

              • se_type
                Tipo: string | null

                tipo di motore di ricerca

              • serp_item_types
                Tipo: array (string | null)[] | null

                tipi di risultati di ricerca nella SERP
                contiene i tipi di risultati di ricerca (items) trovati nella SERP
                tipi di elemento possibili:
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                Nota: i risultati effettivi verranno restituiti solo per gli elementi organic, paid, featured_snippet e local_pack

          • 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

        • 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/keyword_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "include_clickstream_data": true,
    "include_serp_info": true,
    "keywords": [
      "iphone"
    ]
  }
]'

{
  "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,
          "location_code": null,
          "language_code": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword": null,
              "location_code": null,
              "language_code": null,
              "search_partners": null,
              "keyword_info": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
              "clickstream_keyword_info": "[Max Depth Exceeded]",
              "keyword_properties": "[Max Depth Exceeded]",
              "serp_info": "[Max Depth Exceeded]",
              "avg_backlinks_info": "[Max Depth Exceeded]",
              "search_intent_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Keyword Overview