Felo API PlatformFelo API Platform
Alle Endpoints von DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Live-Aufgaben für „Google Ads Search Volume“ einstellen

Felo API Support
MIT
Server:https://openapi.felo.ai
Client-Bibliotheken
Shell Curl

DataForSEO

​

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

DataForSEO Operationen

Live-Aufgaben für „Google Ads Search Volume“ einstellen

​

Google Ads-Suchvolumen für eine Liste von keywords. Gibt keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc und monthly_searches zurück, plus spell, wenn Google den Begriff korrigiert hat. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. Dies ist die klassische Suchvolumenzahl; wie oft Menschen stattdessen einen Assistenten fragen, liefert post_dataforseo_ai_keyword_volume_live. Die Submit- und Fetch-Zwillinge dieses Endpunkts erledigen dieselbe Arbeit asynchron, zum selben Preis, für Stapel, die zu groß zum Warten sind.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.09.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot und keine garantierte Preis- oder Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body
application/json
  • Typ: array (object | null)[]
    • date_from
      Typ: string | null

      Startdatum des Zeitraums
      Optionales Feld
      Datumsformat: "yyyy-mm-dd"
      Mindestwert: 4 Jahre ab dem aktuellen Datum
      Standardmäßig werden Daten für die letzten 12 Monate zurückgegeben;
      Hinweis: Das angegebene Datum darf nicht größer sein als das in date_to angegebene und/oder das gestrige Datum;Wenn Status-Endpunkt im Feld actual_data den Wert false zurückgibt, kann date_from auf den vorletzten Monat und früher gesetzt werden;
      wenn Status-Endpunkt im Feld actual_data den Wert true zurückgibt, kann date_from auf den letzten Monat und früher gesetzt werden

    • date_to
      Typ: string | null

      Enddatum des Zeitraums
      Optionales Feld
      Hinweis: Das angegebene Datum darf nicht weiter als der vergangene Monat zurückliegen, Google Ads liefert keine Daten für den aktuellen Monat;
      Wenn Sie dieses Feld nicht angeben, wird standardmäßig das gestrige Datum verwendet
      Datumsformat: "yyyy-mm-dd"
      Beispiel:
      "2022-11-30"

    • include_adult_keywords
      Typ: boolean | null

      Keywords mit Bezug zu Inhalten für Erwachsene einschließen
      Optionales Feld
      Bei_true werden Keywords für Erwachsene in die Antwort aufgenommen
      Standardwert:false
      Beachten Sie      , dass die API für solche Keywords möglicherweise keine Daten zurückgibt, bedingt durch_Google Ads-Einschränkungenn

    • keywords
      Typ: array string[]

      Keywords
      Pflichtfeld
      Maximale Anzahl der Keywords, die Sie angeben können: 1000
      Maximale Anzahl der Zeichen pro Keyword: 80
      Maximale Anzahl der Wörter pro Keyword-Phrase: 10
      Die von Ihnen angegebenen Keywords werden in Kleinbuchstaben umgewandelt
      Hinweis Nr. 1: Google Ads liefert möglicherweise keine Daten für bestimmte Keyword-Gruppen;
      Hinweis Nr. 2: Google Ads liefert kombinierte Suchvolumenwerte für Gruppen ähnlicher Keywords
      Um das Suchvolumen für ähnliche Keywords zu erhalten, empfehlen wir, solche Keywords in separaten Anfragen zu übermitteln;
      Hinweis Nr. 3: Google Ads erlaubt die Verwendung bestimmter Symbole und Zeichen nicht (z. B. UTF-Symbole, Emojis), daher können Sie sie beim Einstellen einer Aufgabe nicht verwenden;
      Weitere Informationen zu den zulässigen Symbolen und Zeichen finden Sie in diesem Artikel

      Weitere Informationen zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Help-Center-Artikel

    • language_code
      Typ: string | null

      Sprachcode der Suchmaschine
      Optionales Feld
      Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      Beispiel:
      en

    • language_name
      Typ: string | null

      Vollständiger Name der Suchmaschinensprache
      Optionales Feld
      Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      Beispiel:
      English

    • location_code
      Typ: integer | null

      Standortcode der Suchmaschine
      Optionales Feld
      Wenn Sie den Standort nicht angeben, erhalten Sie weltweite Ergebnisse, d. h. für alle verfügbaren Standorte;
      Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_coordinate nicht angeben;
      Die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      Beispiel:
      2840

    • location_coordinate
      Typ: string | null

      GPS-Koordinaten eines Standorts
      Optionales Feld
      Wenn Sie den Standort nicht angeben, erhalten Sie weltweite Ergebnisse, d. h. für alle verfügbaren Standorte;
      Wenn Sie dieses Feld verwenden, müssen Sie location_name oder location_code nicht angeben;
      Der Parameter location_coordinate muss im Format "latitude,longitude" angegeben werden;
      Die Daten werden für das Land bereitgestellt, zu dem die angegebenen Koordinaten gehören;
      Beispiel:
      52.6178549,-155.352142

    • location_name
      Typ: string | null

      Vollständiger Name des Suchmaschinenstandorts
      Optionales Feld
      Wenn Sie den Standort nicht angeben, erhalten Sie weltweite Ergebnisse, d. h. für alle verfügbaren Standorte;
      Wenn Sie dieses Feld verwenden, müssen Sie location_code oder location_coordinate nicht angeben
      Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      Beispiel:
      London,England,United Kingdom

    • search_partners
      Typ: boolean | null

      Google-Suchpartner einbeziehen
      Optionales Feld
      Wenn Sie true angeben, werden die Ergebnisse für eigene, betriebene und syndizierte Netzwerke auf Google- und Partnerseiten geliefert, die die Google-Suche hosten;
      Standardwert: false – Ergebnisse werden für Google-Suchseiten zurückgegeben

    • sort_by
      Typ: string | null

      Sortierparameter für Ergebnisse
      Optionales Feld
      Verwenden Sie diese Parameter, um die Ergebnisse nach relevance, search_volume, competition_index, low_top_of_page_bid oder high_top_of_page_bid in absteigender Reihenfolge zu sortieren
      Standardwert: relevance

    • tag
      Typ: string | null

      Benutzerdefinierte Aufgaben-ID
      Optionales Feld
      Zeichenlimit: 255
      Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
      Den angegebenen Wert tag finden Sie im data-Array der Antwort

Antworten
  • 200
    Typ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo
    • cost
      Typ: number | null Format: double

      Gesamtkosten der Aufgaben in USD

    • status_code
      Typ: integer | null

      allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

    • status_message
      Typ: string | null

      allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

    • tasks
      Typ: array (object | null)[] | null

      Array von Aufgaben

      • Typ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
        • cost
          Typ: number | null Format: double

          Gesamtkosten der Aufgaben in USD

        • data
          Typ: object | null

          Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

          • propertyName
            Typ: object | null
        • id
          Typ: string | null

          Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

        • path
          Typ: array (string | null)[] | null

          URL-Pfad

        • result
          Typ: array (object | null)[] | null

          Array von Ergebnissen

          • competition
            Typ: string | null

            Wettbewerb
            gibt die relative Wettbewerbsintensität für das jeweilige Keyword ausschließlich in der bezahlten SERP an;
            dieser Wert basiert auf Google Ads-Daten und kann folgende Werte annehmen: HIGH, MEDIUM, LOW;
            liegen keine Daten vor, ist der Wert null;
            mehr über die Metrik erfahren Sie in diesem Help-Center-Artikel

          • competition_index
            Typ: integer | null

            Wettbewerb
            gibt die relative Wettbewerbsintensität für das jeweilige Keyword ausschließlich in der bezahlten SERP an;
            dieser Wert basiert auf Google Ads-Daten und kann zwischen 0 und 100 (einschließlich) liegen;
            liegen keine Daten vor, ist der Wert null;
            mehr über die Metrik erfahren Sie in diesem Help-Center-Artikel

          • cpc
            Typ: number | null

            Kosten pro Klick
            gibt den Betrag (USD) an, der für jeden Klick auf die für ein bestimmtes Keyword angezeigte Anzeige bezahlt wird

          • high_top_of_page_bid
            Typ: number | null

            maximales Gebot, damit die Anzeige oben auf der ersten Seite erscheint
            gibt den Wert an, der über etwa 80 % der niedrigsten Gebote liegt, für die Anzeigen ausgeliefert wurden (basierend auf Google Ads-Statistiken für Werbetreibende);
            der Wert kann je nach dem in einer POST-Anfrage angegebenen Standort abweichen

          • keyword
            Typ: string | null

            Keyword
            das Keyword wird mit dekodiertem %## zurückgegeben (das Pluszeichen '+' wird in ein Leerzeichen dekodiert)

          • language_code
            Typ: string | null

            Sprachcode in einem POST-Array
            liegen keine Daten vor, ist der Wert null

          • location_code
            Typ: integer | null

            Standortcode in einem POST-Array
            liegen keine Daten vor, ist der Wert null

          • low_top_of_page_bid
            Typ: number | null

            minimales Gebot, damit die Anzeige oben auf der ersten Seite erscheint
            gibt den Wert an, der über etwa 20 % der niedrigsten Gebote liegt, für die Anzeigen ausgeliefert wurden (basierend auf Google Ads-Statistiken für Werbetreibende);
            der Wert kann je nach dem in einer POST-Anfrage angegebenen Standort abweichen

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

            monatliche Suchanfragen
            stellt die (ungefähre) Anzahl der Suchanfragen zu dieser Keyword-Idee dar (standardmäßig verfügbar für die letzten zwölf Monate), ausgerichtet auf die angegebenen geografischen Standorte;
            liegen keine Daten vor, ist der Wert null

            • month
              Typ: integer | null

              Monat

            • search_volume
              Typ: integer | null

              durchschnittliche monatliche Suchvolumenrate

            • year
              Typ: integer | null

              Jahr

          • search_partners
            Typ: boolean | null

            gibt an, ob Daten aus Partnernetzwerken in der Antwort enthalten sind

          • search_volume
            Typ: integer | null Format: int64

            durchschnittliches monatliches Suchvolumen;
            stellt die (ungefähre) Anzahl der Suchanfragen für die jeweilige Keyword-Idee auf google.com oder auf google.com und Partnern dar, abhängig vom Targeting des Nutzers;
            liegen keine Daten vor, ist der Wert null

          • spell
            Typ: string | null

            korrekte Schreibweise des Keywords
            Hinweis:erscheint das Keyword im POST-Array falsch geschrieben, werden Daten für das korrekt geschriebene Keyword zurückgegeben;
            wir nutzen die Funktionalität der Google Ads API, um die Schreibweise von Keywords zu prüfen und zu validieren, mehr dazu unter diesem Link

        • result_count
          Typ: integer | null Format: int64

          Anzahl der Elemente im Ergebnis-Array

        • status_code
          Typ: integer | null

          Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

        • status_message
          Typ: string | null

          Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

        • time
          Typ: string | null

          Ausführungszeit in Sekunden

    • tasks_count
      Typ: integer | null Format: int64

      Die Anzahl der Aufgaben im tasks-Array

    • tasks_error
      Typ: integer | null Format: int64

      Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

    • time
      Typ: string | null

      Gesamtausführungszeit, Sekunden

    • version
      Typ: string | null

      Die aktuelle Version der API

    application/json
  • 400

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

    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
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Setting Live ‘Google Ads Search Volume’ Tasks