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

Live-Aufgaben für „DataForSEO Trends Explore“ 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 „DataForSEO Trends Explore“ einstellen

​

Zeitverlauf des Interesses für bis zu fünf keywords, die Google Trends-Kurve. Gibt keywords, type, location_code, language_code, datetime, items_count und items zurück. type wählt web, news, images, youtube oder shopping, und date_from/date_to legen den Zeitraum fest. 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. Trends liefert relatives Interesse, kein absolutes Volumen; für Zahlen verwenden Sie post_dataforseo_keywords_gads_search_volume_live.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.0012.
  • 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
      wenn Sie dieses Feld nicht angeben, wird standardmäßig der heutige Tag und Monat des Vorjahres verwendet
      Mindestwert für den Typ web: 2004-01-01
      Mindestwert für andere Typen: 2008-01-01
      Datumsformat: "yyyy-mm-dd"
      Beispiel:
      "2019-01-15"

    • date_to
      Typ: string | null

      Enddatum des Zeitraums
      Optionales Feld
      wenn Sie dieses Feld nicht angeben, wird standardmäßig das heutige Datum verwendet
      Datumsformat: "yyyy-mm-dd"
      Beispiel:
      "2019-01-15"

    • keywords
      Typ: array string[]

      keywords
      Pflichtfeld
      maximale Anzahl der Keywords, die Sie angeben können: 5

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

    • location_code
      Typ: integer | null

      Standortcode der Suchmaschine
      Optionales Feld
      Wenn Sie dieses Feld nicht verwenden, erhalten Sie globale Ergebnisse
      Wenn Sie dieses Feld verwenden, müssen Sie location_name 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/dataforseo_trends/locations
      Beachten Sie, dass die Daten für das Land bereitgestellt werden, zu dem der angegebene location_code gehört;
      Beispiel:
      2840

    • location_name
      Typ: string | null

      Vollständiger Name des Suchmaschinenstandorts
      Optionales Feld
      Wenn Sie dieses Feld nicht verwenden, erhalten Sie globale Ergebnisse
      Wenn Sie dieses Feld verwenden, müssen Sie location_code 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/dataforseo_trends/locations
      Beachten Sie, dass die Daten für das Land bereitgestellt werden, zu dem der angegebene location_name gehört;
      Beispiel:
      United Kingdom

    • 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

    • time_range
      Typ: string | null

      voreingestellte Zeiträume
      Optionales Feld
      Wenn Sie die Parameter date_from oder date_to angeben, wird dieses Feld beim Einstellen einer Aufgabe ignoriert
      mögliche Werte für alle type-Parameter:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      Typ: string | null

      Elementtyp

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

          • datetime
            Typ: string | null

            Datum und Uhrzeit des Eingangs des Ergebnisses
            im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
            Beispiel:
            2019-11-15 12:57:46 +00:00

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

            enthält Keyword-Popularität und zugehörige Daten

            • Typ: object | null · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                • Typ: object · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                  • type
                    Diskriminator
                    Typ: string | null

                    Elementtyp

                  • averages
                    Typ: array (integer | null)[] | null
                  • data
                    Typ: array (object | null)[] | null

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

                    • date_from
                      Typ: string | null

                      Startdatum des entsprechenden Zeitraums
                      im UTC-Format: "yyyy-mm-dd"

                    • date_to
                      Typ: string | null

                      Enddatum des entsprechenden Zeitraums
                      im UTC-Format: "yyyy-mm-dd"

                    • timestamp
                      Typ: integer | null

                      ein Zeitpunkt im Unix-Zeitformat

                    • values
                      Typ: array (integer | null)[] | null

                      relative Keyword-Popularitätsrate zu einem bestimmten Zeitstempel
                      stellt die Keyword-Popularitätsrate über den angegebenen Zeitraum dar
                      wenn Sie mehr als ein Keyword angeben, werden die Werte auf den höchsten Wert über alle angegebenen Keywords gemittelt
                      ein Wert von 100 ist die Spitzenpopularität des Begriffs. Ein Wert von 50 bedeutet, dass der Begriff halb so populär ist. Ein Wert von 0 bedeutet, dass nicht genügend Daten für diesen Begriff vorlagen

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

                    Keywords in einem POST-Array

                  • position
                    Typ: integer | null

                    die Ausrichtung des Elements
                    kann folgende Werte annehmen: 1, 2, 3, 4, usw.

          • items_count
            Typ: integer | null Format: int64

            die Anzahl der im items-Array zurückgegebenen Ergebnisse

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

            Keywords 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

          • type
            Typ: string | null

            Elementtyp

        • 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/dataforseo_trends/explore/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/explore/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "iphone 14",
      "samsung s23"
    ],
    "location_code": 2840
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "data": "[Max Depth Exceeded]",
              "averages": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Setting Live ‘DataForSEO Trends Explore’ Tasks