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

Live-Aufgaben für „Bing Keyword Performance“ 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 „Bing Keyword Performance“ einstellen

​

Wie sich eine Liste von keywords in Bing Ads für einen bestimmten device und match-Typ verhält. ⚠️ language_name ist erforderlich, und sein Fehlen wird als Invalid Field: 'language_name' innerhalb eines HTTP 200 gemeldet – die Meldung bedeutet sowohl fehlend als auch falsch. 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. Gültige Paare stammen aus get_dataforseo_keywords_bing_kw_performance_locales. 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)[]
    • 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: desktop, mobile, tablet, all
      Standardwert: all

    • keywords
      Typ: array string[]

      keywords
      Pflichtfeld
      Maximale Anzahl der Keywords, die Sie angeben können: 1000
      Maximale Zeichenzahl pro Keyword: 80
      Maximale Wortzahl pro Keyword-Phrase: 10
      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
      Die Liste der verfügbaren Standorte und Sprachen erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      Beispiel:
      "en"

    • 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
      Die Liste der verfügbaren Standorte und Sprachen erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      Beispiel:
      English

    • 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 und Sprachen erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      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 und Sprachen erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      Beispiel:
      "United States"

    • match
      Typ: string | null

      Übereinstimmungstyp für Keywords
      Optionales Feld
      kann folgende Werte annehmen:
      aggregate liefert Daten über alle Übereinstimmungstypen hinweg;
      broad liefert Daten für alle Nutzeranfragen, die das angegebene Keyword in unterschiedlicher Wortreihenfolge enthalten;
      phrase liefert Daten für alle Nutzeranfragen, die das angegebene Keyword in identischer Wortreihenfolge enthalten;
      exact liefert Daten für Nutzeranfragen, die dem angegebenen Keyword entsprechen;Hinweis: der Übereinstimmungstyp aggregate wird standardmäßig angewendet

    • 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_KeywordsDataBingKeywordPerformanceLiveResponseInfo
    • 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_KeywordsDataBingKeywordPerformanceLiveTaskInfo
        • 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

          • keyword
            Typ: string | null

            Keyword in einem POST-Array

          • keyword_kpi
            Typ: object | null · Response36Afe1097B20_KeywordKpi

            Objekt mit Keyword-Metriken
            liegen keine Daten vor, ist der Wert null

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

              für Desktop-Geräte aggregierte Keyword-Daten
              liegen keine Daten vor, ist der Wert null

              • ad_position
                Typ: string | null

                gibt die Position der relevanten Anzeige in der SERP an
                kann folgende Werte annehmen:
                FirstPage1: Die erste Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage2: Die zweite Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage3: Die dritte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage4: Die vierte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage5: Die fünfte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage6: Die sechste Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage7: Die siebte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage8: Die achte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage9: Die neunte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage10: Die zehnte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                MainLine1: Die erste Anzeige oben auf der Suchergebnisseite
                MainLine2: Die zweite Anzeige oben auf der Suchergebnisseite
                MainLine3: Die dritte Anzeige oben auf der Suchergebnisseite
                MainLine4: Die vierte Anzeige oben auf der Suchergebnisseite

              • average_bid
                Typ: number | null Format: double

                durchschnittliches Gebot des Keywords

              • average_cpc
                Typ: number | null Format: double

                durchschnittliche Kosten pro Klick, USD
                berechnet als Kosten aller Klicks geteilt durch die Anzahl der Klicks

              • clicks
                Typ: integer | null

                Anzeigenklicks
                die Anzahl der Klicks, die das Keyword und der Übereinstimmungstyp im letzten Monat erzeugt haben

              • ctr
                Typ: number | null Format: double

                Klickrate in Prozent
                berechnet als Anzahl der Klicks geteilt durch die Anzahl der Impressionen, multipliziert mit 100

              • impressions
                Typ: integer | null

                Anzeigenimpressionen
                die Anzahl der Impressionen, die das Keyword und der Übereinstimmungstyp im letzten Monat erzeugt haben

              • total_cost
                Typ: number | null Format: int64

                Gesamtkosten einer Anzeige, USD
                die Kosten für die Verwendung des angegebenen Keywords und Übereinstimmungstyps im letzten Monat

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

              für Mobilgeräte aggregierte Keyword-Daten
              liegen keine Daten vor, ist der Wert null

              • ad_position
                Typ: string | null

                gibt die Position der relevanten Anzeige in der SERP an
                kann folgende Werte annehmen:
                FirstPage1: Die erste Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage2: Die zweite Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage3: Die dritte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage4: Die vierte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage5: Die fünfte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage6: Die sechste Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage7: Die siebte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage8: Die achte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage9: Die neunte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage10: Die zehnte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                MainLine1: Die erste Anzeige oben auf der Suchergebnisseite
                MainLine2: Die zweite Anzeige oben auf der Suchergebnisseite
                MainLine3: Die dritte Anzeige oben auf der Suchergebnisseite
                MainLine4: Die vierte Anzeige oben auf der Suchergebnisseite

              • average_bid
                Typ: number | null Format: double

                durchschnittliches Gebot des Keywords

              • average_cpc
                Typ: number | null Format: double

                durchschnittliche Kosten pro Klick, USD
                berechnet als Kosten aller Klicks geteilt durch die Anzahl der Klicks

              • clicks
                Typ: integer | null

                Anzeigenklicks
                die Anzahl der Klicks, die das Keyword und der Übereinstimmungstyp im letzten Monat erzeugt haben

              • ctr
                Typ: number | null Format: double

                Klickrate in Prozent
                berechnet als Anzahl der Klicks geteilt durch die Anzahl der Impressionen, multipliziert mit 100

              • impressions
                Typ: integer | null

                Anzeigenimpressionen
                die Anzahl der Impressionen, die das Keyword und der Übereinstimmungstyp im letzten Monat erzeugt haben

              • total_cost
                Typ: number | null Format: int64

                Gesamtkosten einer Anzeige, USD
                die Kosten für die Verwendung des angegebenen Keywords und Übereinstimmungstyps im letzten Monat

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

              für Tablets aggregierte Keyword-Daten
              liegen keine Daten vor, ist der Wert null

              • ad_position
                Typ: string | null

                gibt die Position der relevanten Anzeige in der SERP an
                kann folgende Werte annehmen:
                FirstPage1: Die erste Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage2: Die zweite Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage3: Die dritte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage4: Die vierte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage5: Die fünfte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage6: Die sechste Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage7: Die siebte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage8: Die achte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage9: Die neunte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                FirstPage10: Die zehnte Anzeige auf der rechten Seite der ersten Suchergebnisseite
                MainLine1: Die erste Anzeige oben auf der Suchergebnisseite
                MainLine2: Die zweite Anzeige oben auf der Suchergebnisseite
                MainLine3: Die dritte Anzeige oben auf der Suchergebnisseite
                MainLine4: Die vierte Anzeige oben auf der Suchergebnisseite

              • average_bid
                Typ: number | null Format: double

                durchschnittliches Gebot des Keywords

              • average_cpc
                Typ: number | null Format: double

                durchschnittliche Kosten pro Klick, USD
                berechnet als Kosten aller Klicks geteilt durch die Anzahl der Klicks

              • clicks
                Typ: integer | null

                Anzeigenklicks
                die Anzahl der Klicks, die das Keyword und der Übereinstimmungstyp im letzten Monat erzeugt haben

              • ctr
                Typ: number | null Format: double

                Klickrate in Prozent
                berechnet als Anzahl der Klicks geteilt durch die Anzahl der Impressionen, multipliziert mit 100

              • impressions
                Typ: integer | null

                Anzeigenimpressionen
                die Anzahl der Impressionen, die das Keyword und der Übereinstimmungstyp im letzten Monat erzeugt haben

              • total_cost
                Typ: number | null Format: int64

                Gesamtkosten einer Anzeige, USD
                die Kosten für die Verwendung des angegebenen Keywords und Übereinstimmungstyps im letzten Monat

          • 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

          • month
            Typ: integer | null

            gibt den Monat an, für den die Daten bereitgestellt werden
            Beispiel:
            10

          • year
            Typ: integer | null

            gibt das Jahr an, für das die Daten bereitgestellt werden
            Beispiel:
            2020

        • 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/keyword_performance/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "keywords": [
      "dataforseo",
      "seo",
      "ranking"
    ]
  }
]'

{
  "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,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Setting Live ‘Bing Keyword Performance’ Tasks