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

Impostare le attività live ‘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 ‘Search Volume’

​

Volume di ricerca Bing per un elenco di keywords. Restituisce keyword, location_code, language_code, search_partners, device, competition, cpc, search_volume, categories e monthly_searches – nota categories, che l'equivalente Google non restituisce, e l'assenza di competition_index. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Il gemello Google è post_dataforseo_keywords_gads_search_volume_live; esegui entrambi quando il pubblico non è solo su Google. 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 comunicato.
  • Stima di riferimento per richiesta: USD 0.09.
  • 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)[]
    • date_from
      Tipo: string | null

      data di inizio dell'intervallo di tempo
      campo facoltativo
      valore minimo: 24 mesi dalla data odierna;
      se non specifichi questo campo, i dati verranno forniti per gli ultimi 12 mesi;
      valore minimo: due anni indietro dalla data odierna;
      se l'endpoint Status restituisce false nel campo actual_data, date_from può essere impostato al mese prima dell'ultimo e precedenti;
      se l'endpoint Status restituisce true nel campo actual_data, date_from può essere impostato all'ultimo mese e precedenti;
      formato data: "yyyy-mm-dd"
      esempio:
      "2020-01-01"Nota: non consigliamo di usare un intervallo di tempo personalizzato per le date dell'anno passato

    • date_to
      Tipo: string | null

      data di fine dell'intervallo di tempo
      campo facoltativo
      se non specifichi questo campo, i dati verranno forniti per gli ultimi 12 mesi;
      valore minimo: due anni indietro dalla data odierna;
      valore massimo: un mese dalla data odierna;
      nota: non consigliamo di usare un intervallo di tempo personalizzato per le date dell'anno passato;
      formato data: "yyyy-mm-dd"
      esempio:
      "2020-03-15"Nota: non consigliamo di usare un intervallo di tempo personalizzato per le date dell'anno passato

    • device
      Tipo: string | null

      tipo di dispositivo
      campo facoltativo
      specifica questo campo se vuoi ottenere i dati per un determinato tipo di dispositivo;
      valori possibili: all, mobile, desktop, tablet
      valore predefinito: all

    • keywords
      Tipo: array string[]

      keywords
      campo obbligatorio
      Numero massimo di keyword specificabili: 1000
      Numero massimo di caratteri per ogni keyword: 100
      le keyword specificate verranno convertite in minuscolo, i dati verranno forniti in un array separato. 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

      codice lingua del motore di ricerca
      campo obbligatorio se non specifichi language_name
      se usi questo campo, non devi specificare language_name
      lingue supportate:
      en, fr, de

    • language_name
      Tipo: string

      nome completo della lingua del motore di ricerca
      campo obbligatorio se non specifichi language_code
      se usi questo campo, non devi specificare language_code
      lingue supportate:
      English, French, German

    • location_code
      Tipo: integer

      codice località del motore di ricerca
      campo obbligatorio se non specifichi location_name o location_coordinate
      se usi questo campo, non devi specificare location_name o location_coordinate
      puoi ottenere 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/bing/locations
      esempio:
      2840

    • location_coordinate
      Tipo: string

      coordinate GPS di una località
      campo obbligatorio se non specifichi location_name o location_code
      se usi questo campo, non devi 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

      nome completo della località del motore di ricerca
      campo obbligatorio se non specifichi location_code o location_coordinate
      se usi questo campo, non devi specificare location_code o location_coordinate
      puoi ottenere 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/bing/locations
      esempio:
      London,England,United Kingdom

    • search_partners
      Tipo: boolean | null

      tipo di partner di ricerca Bing
      campo facoltativo
      se specifichi true, i risultati verranno forniti per reti di proprietà, gestite e sindacate in Bing, Yahoo, AOL e siti partner che ospitano ricerche Bing, AOL e Yahoo.
      valore predefinito: false - i risultati vengono restituiti per le reti di ricerca Bing, AOL e Yahoo

    • sort_by
      Tipo: string | null

      parametri di ordinamento dei risultati
      campo facoltativo
      usa questi parametri per ordinare i risultati per search_volume, cpc, competition o relevance 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'oggetto data della risposta

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

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

            categorie di prodotti e servizi
            la nostra API non restituisce categorie per questo endpoint: il parametro è sempre null

          • competition
            Tipo: number | null

            concorrenza
            rappresenta l'intensità relativa della concorrenza per la keyword specificata, esclusivamente nella SERP a pagamento. Questo valore si basa sui dati di Bing Ads.
            valori possibili: 0.1, 0.5,0.90.1 - concorrenza bassa,
            0.5 - concorrenza media,
            0.9 - concorrenza alta;
            se non ci sono dati, il valore è null

          • cpc
            Tipo: number | null

            costo per clic
            rappresenta il costo medio per clic (USD) storicamente pagato per la keyword.
            se non ci sono dati, il valore è null

          • device
            Tipo: string | null

            tipo di dispositivo in un array POST
            se non ci sono dati, il valore è null

          • keyword
            Tipo: string | null

            keyword in un array POST

          • 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

          • 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
            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 nel motore di ricerca Bing, in base al targeting dell'utente;
            il volume di ricerca viene arrotondato alle decine più vicine;
            se non ci sono dati, il valore è null

        • 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/bing/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

{
  "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,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Setting Live ‘Search Volume’ Tasks