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

Search-Volume-Ergebnisse nach ID abrufen

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

Search-Volume-Ergebnisse nach ID abrufen

​

Ruft eine in die Warteschlange gestellte Google Ads-Suchvolumen-Aufgabe anhand von id ab. Gleiche Struktur wie post_dataforseo_keywords_gads_search_volume_live. 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.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.012.
  • 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.

Pfadparameter
  • id
    Typ: string
    erforderlich

    Aufgaben-ID
    eindeutige Aufgaben-ID in unserem System im UUID-Format
    Sie können sie 30 Tage lang verwenden, um die Ergebnisse der Aufgabe jederzeit abzurufen

Antworten
  • 200
    Typ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo
    • 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_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo
        • 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

          • 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 get/v1/beta/dataforseo/keywords_data/google_ads/search_volume/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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

Get Search Volume Results by id