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

Live-Aufgaben für „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 „Search Volume“ einstellen

​

Bing-Suchvolumen für eine Liste von keywords. Gibt keyword, location_code, language_code, search_partners, device, competition, cpc, search_volume, categories und monthly_searches zurück – beachten Sie categories, das das Google-Äquivalent nicht zurückgibt, und das Fehlen von competition_index. 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. Das Google-Pendant ist post_dataforseo_keywords_gads_search_volume_live; führen Sie beide aus, wenn die Zielgruppe nicht nur Google ist. Die Submit- und Fetch-Pendants dieses Endpunkts erledigen dieselbe Arbeit asynchron, zum selben Preis, für Batches, die zu groß zum Warten sind.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.09.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine 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
      Mindestwert: 24 Monate ab dem heutigen Datum;
      wenn Sie dieses Feld nicht angeben, werden Daten für die letzten 12 Monate geliefert;
      Mindestwert: zwei Jahre vor dem heutigen Datum;
      wenn der Status-Endpunkt false für das Feld actual_data zurückgibt, kann date_from auf den vorletzten Monat und davor gesetzt werden;
      wenn der Status-Endpunkt true für das Feld actual_data zurückgibt, kann date_from auf den letzten Monat und davor gesetzt werden;
      Datumsformat: "yyyy-mm-dd"
      Beispiel:
      "2020-01-01"Hinweis: wir empfehlen nicht, einen benutzerdefinierten Zeitraum für Daten des vergangenen Jahres zu verwenden

    • date_to
      Typ: string | null

      Enddatum des Zeitraums
      Optionales Feld
      wenn Sie dieses Feld nicht angeben, werden Daten für die letzten 12 Monate geliefert;
      Mindestwert: zwei Jahre vor dem heutigen Datum;
      Höchstwert: ein Monat ab dem heutigen Datum;
      Hinweis: wir empfehlen nicht, einen benutzerdefinierten Zeitraum für Daten des vergangenen Jahres zu verwenden;
      Datumsformat: "yyyy-mm-dd"
      Beispiel:
      "2020-03-15"Hinweis: wir empfehlen nicht, einen benutzerdefinierten Zeitraum für Daten des vergangenen Jahres zu verwenden

    • device
      Typ: string | null

      Gerätetyp
      Optionales Feld
      Geben Sie dieses Feld an, wenn Sie die Daten für einen bestimmten Gerätetyp abrufen möchten;
      mögliche Werte: all, mobile, desktop, tablet
      Standardwert: all

    • keywords
      Typ: array string[]

      keywords
      Pflichtfeld
      Maximale Anzahl der Keywords, die Sie angeben können: 1000
      Maximale Zeichenzahl pro Keyword: 100
      die angegebenen Keywords werden in Kleinbuchstaben umgewandelt, die Daten werden in einem separaten Array geliefert. 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

      Sprachcode der Suchmaschine
      Pflichtfeld, wenn nicht angegeben language_name
      bei Verwendung dieses Feldes ist keine Angabe von language_name nötig
      unterstützte Sprachen:
      en, fr, de

    • language_name
      Typ: string

      vollständiger Name der Suchmaschinensprache
      Pflichtfeld, wenn nicht angegeben language_code
      bei Verwendung dieses Feldes ist keine Angabe von language_code nötig
      unterstützte Sprachen:
      English, French, German

    • location_code
      Typ: integer

      Standortcode der Suchmaschine
      Pflichtfeld, wenn nicht angegeben location_name oder location_coordinate
      bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_coordinate nötig
      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/bing/locations
      Beispiel:
      2840

    • location_coordinate
      Typ: string

      GPS-Koordinaten eines Standorts
      Pflichtfeld, wenn nicht angegeben location_name oder location_code
      bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_code nötig
      Der Parameter location_coordinate muss im Format "latitude,longitude" angegeben werden
      die Daten werden für das Land geliefert, zu dem die angegebenen Koordinaten gehören
      Beispiel:
      52.6178549,-155.352142

    • location_name
      Typ: string

      vollständiger Name des Suchmaschinenstandorts
      Pflichtfeld, wenn nicht angegeben location_code oder location_coordinate
      bei Verwendung dieses Feldes ist keine Angabe von location_code oder location_coordinate nötig
      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/bing/locations
      Beispiel:
      London,England,United Kingdom

    • search_partners
      Typ: boolean | null

      Typ der Bing-Suchpartner
      Optionales Feld
      wenn Sie true angeben, werden die Ergebnisse für eigene, betriebene und syndizierte Netzwerke über Bing, Yahoo, AOL und Partnerseiten geliefert, die Bing-, AOL- und Yahoo-Suche hosten.
      Standardwert: false - Ergebnisse werden für die Suchnetzwerke Bing, AOL und Yahoo zurückgegeben

    • sort_by
      Typ: string | null

      Parameter für die Sortierung der Ergebnisse
      Optionales Feld
      Verwenden Sie diese Parameter, um die Ergebnisse nach search_volume, cpc, competition oder relevance 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-Objekt der Antwort

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

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

            Produkt- und Dienstleistungskategorien
            unsere API gibt für diesen Endpunkt keine Kategorien zurück: der Parameter ist immer null

          • competition
            Typ: number | null

            Wettbewerb
            gibt die relative Wettbewerbsintensität für das jeweilige Keyword ausschließlich in der bezahlten SERP an. Der Wert basiert auf Bing Ads-Daten.
            Mögliche Werte: 0.1, 0.5,0.90.1 - geringer Wettbewerb,
            0.5 - mittlerer Wettbewerb,
            0.9 - hoher Wettbewerb;
            liegen keine Daten vor, ist der Wert null

          • cpc
            Typ: number | null

            Kosten pro Klick
            gibt die durchschnittlichen Kosten pro Klick (USD) an, die für das Keyword historisch bezahlt wurden.
            liegen keine Daten vor, ist der Wert null

          • device
            Typ: string | null

            Gerätetyp in einem POST-Array
            liegen keine Daten vor, ist der Wert null

          • keyword
            Typ: string | null

            Keyword in einem POST-Array

          • 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

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

            monatliche Suchanfragen
            stellt die (ungefähre) Anzahl der Suchanfragen zu dieser Keyword-Idee dar (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 in der Bing-Suchmaschine dar, abhängig vom Targeting des Nutzers;
            das Suchvolumen wird auf die nächsten Zehner gerundet;
            liegen keine Daten vor, ist der Wert null

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

Erfolgreicher Vorgang

Setting Live ‘Search Volume’ Tasks