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

Impostare le attività live ‘Google Ads Search Volume’

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

Impostare le attività live ‘Google Ads Search Volume’

​

Volume di ricerca Google Ads per un elenco di keywords. Restituisce keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc e monthly_searches, più spell quando Google ha corretto il termine. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200. Questo è il numero classico di volume di ricerca; per la frequenza con cui le persone chiedono invece a un assistente, usa post_dataforseo_ai_keyword_volume_live. I gemelli submit e fetch di questo endpoint svolgono lo stesso lavoro in modo asincrono, allo stesso prezzo, per batch troppo grandi per attendere.

Riferimento prezzi

  • Misurazione: costo della risposta riportato.
  • Stima di riferimento per richiesta: USD 0.09.
  • 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)[]
    • date_from
      Tipo: string | null

      data di inizio dell'intervallo di tempo
      campo facoltativo
      formato data: "yyyy-mm-dd"
      valore minimo: 4 anni dalla data corrente
      per impostazione predefinita, i dati vengono restituiti per gli ultimi 12 mesi;
      Nota: la data indicata non può essere successiva a quella specificata in date_to e/o alla data di ieri;se l'endpoint Status restituisce false nel campo actual_data, date_from può essere impostato al mese precedente a quello scorso e precedenti;
      se l'endpoint Status restituisce true nel campo actual_data, date_from può essere impostato al mese scorso e precedenti

    • date_to
      Tipo: string | null

      data di fine dell'intervallo di tempo
      campo facoltativo
      Nota: la data indicata non può essere precedente al mese scorso; Google Ads non restituisce dati sul mese corrente;
      se non si specifica questo campo, per impostazione predefinita viene usata la data di ieri
      formato data: "yyyy-mm-dd"
      esempio:
      "2022-11-30"

    • include_adult_keywords
      Tipo: boolean | null

      includi keywords associate a contenuti per adulti
      campo facoltativo
      se impostato su_true, le keywords per adulti verranno incluse nella risposta
      valore predefinito:_false
      notache l'API potrebbe non restituire dati per tali keywords a causa dellerestrizioni di Google Adsn

    • keywords
      Tipo: array string[]

      keywords
      campo obbligatorio
      numero massimo di keywords specificabili: 1000
      numero massimo di caratteri per keyword: 80
      numero massimo di parole per frase keyword: 10
      le keywords specificate verranno convertite in minuscolo
      Nota n. 1: Google Ads potrebbe non restituire dati per determinati gruppi di keywords;
      Nota n. 2: Google Ads fornisce valori di volume di ricerca combinati per gruppi di keywords simili
      per ottenere il volume di ricerca di keywords simili, si consiglia di inviare tali keywords in richieste separate;
      Nota n. 3: Google Ads non consente l'uso di determinati simboli e caratteri (ad es. simboli UTF, emoji), pertanto non è possibile usarli durante l'impostazione di un'attività;
      per scoprire quali simboli e caratteri è possibile usare, consultare questo articolo

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

    • language_code
      Tipo: string | null

      codice lingua del motore di ricerca
      campo facoltativo
      è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_code effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      esempio:
      en

    • language_name
      Tipo: string | null

      nome completo della lingua del motore di ricerca
      campo facoltativo
      è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_name effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      esempio:
      English

    • location_code
      Tipo: integer | null

      codice località del motore di ricerca
      campo facoltativo
      se non si indica la località, si riceveranno risultati mondiali, ovvero per tutte le località disponibili;
      se si usa questo campo, non è necessario specificare location_name o location_coordinate;
      è possibile ricevere l'elenco delle località disponibili dei motori di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      esempio:
      2840

    • location_coordinate
      Tipo: string | null

      coordinate GPS di una località
      campo facoltativo
      se non si indica la località, si riceveranno risultati mondiali, ovvero per tutte le località disponibili;
      se si usa questo campo, non è necessario specificare location_name o location_code;
      il parametro location_coordinate deve essere specificato nel formato "latitude,longitude";
      i dati verranno forniti per il paese a cui appartengono le coordinate specificate;
      esempio:
      52.6178549,-155.352142

    • location_name
      Tipo: string | null

      nome completo della località del motore di ricerca
      campo facoltativo
      se non si indica la località, si riceveranno risultati mondiali, ovvero per tutte le località disponibili;
      se si usa questo campo, non è necessario specificare location_code o location_coordinate
      è possibile ricevere l'elenco delle località disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      esempio:
      London,England,United Kingdom

    • search_partners
      Tipo: boolean | null

      includi partner di ricerca Google
      campo facoltativo
      se si specifica true, i risultati verranno forniti per reti di proprietà, gestite e sindacate su siti Google e partner che ospitano la ricerca Google;
      valore predefinito: false - i risultati vengono restituiti per i siti di ricerca Google

    • sort_by
      Tipo: string | null

      parametri di ordinamento dei risultati
      campo facoltativo
      usare questi parametri per ordinare i risultati per relevance, search_volume, competition_index, low_top_of_page_bid o high_top_of_page_bid in ordine decrescente
      valore predefinito: relevance

    • 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'array data della risposta

Risposte
  • 200
    Tipo: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo
    • 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_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
        • 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

          • competition
            Tipo: string | null

            concorrenza
            rappresenta l'intensità relativa della concorrenza per la keyword specificata, esclusivamente nella SERP a pagamento;
            questo valore si basa sui dati di Google Ads e può assumere i seguenti valori: HIGH, MEDIUM, LOW;
            se non ci sono dati, il valore è null;
            scopri di più sulla metrica in questo articolo dell'Help Center

          • competition_index
            Tipo: integer | null

            concorrenza
            rappresenta l'intensità relativa della concorrenza per la keyword specificata, esclusivamente nella SERP a pagamento;
            questo valore si basa sui dati di Google Ads e può essere compreso tra 0 e 100 (inclusi);
            se non ci sono dati, il valore è null;
            scopri di più sulla metrica in questo articolo dell'Help Center

          • cpc
            Tipo: number | null

            costo per clic
            indica l'importo (USD) pagato per ogni clic sull'annuncio mostrato per una determinata 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

          • keyword
            Tipo: string | null

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

          • 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

          • 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 impostazione predefinita per gli ultimi dodici mesi), indirizzate alle località geografiche specificate;
            se non ci sono dati, il valore è null

            • month
              Tipo: integer | null

              Mese

            • search_volume
              Tipo: integer | null

              tasso medio mensile di volume di ricerca

            • year
              Tipo: integer | null

              Anno

          • search_partners
            Tipo: boolean | null

            indica se nella risposta sono inclusi i dati delle reti partner

          • search_volume
            Tipo: integer | null Formato: int64

            volume di ricerca medio mensile;
            rappresenta il numero (approssimativo) di ricerche per l'idea di keyword in questione su google.com o su google.com e partner, in base al targeting dell'utente;
            se non ci sono dati, il valore è null

          • spell
            Tipo: string | null

            ortografia corretta della keyword
            Nota:se la keyword nell'array POST sembra scritta in modo errato, vengono restituiti i dati per la keyword scritta correttamente;
            utilizziamo la funzionalità dell'API Google Ads per controllare e validare l'ortografia delle keyword, scopri di più a questo link

        • 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/keywords_data/google_ads/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "buy laptop",
      "cheap laptops for sale",
      "purchase laptop"
    ],
    "date_from": "2021-08-01",
    "search_partners": true
  }
]'

{
  "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": [
        {
          "keyword": null,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Setting Live ‘Google Ads Search Volume’ Tasks