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

Historische Traffic-Schätzung in Bulk

Server:https://openapi.felo.ai
Client-Bibliotheken

DataForSEO

​

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

Historische Traffic-Schätzung in Bulk

​

Geschätzter organischer Traffic für viele Domains zu jedem Zeitpunkt der verfügbaren Historie – die Zeitreihe hinter post_dataforseo_labs_google_bulk_traffic_estimation_live. Dieser Endpunkt hat keinen Limit-Parameter, wird aber pro Aufruf statt pro Element abgerechnet – senden Sie daher die gesamte Liste auf einmal. Eingebettet in das DataForSEO-Envelope: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage liefert weiterhin HTTP 200. ⚠️ Die Antwortgröße multipliziert Domains mit Daten; halten Sie beide Listen kurz. Verfügbare Daten stammen aus get_dataforseo_labs_google_available_history.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.1356.
  • 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, werden die Daten für die letzten 12 Monate bereitgestellt
      minimal möglicher Wert: 2020-10-01
      Datumsformat: "yyyy-mm-dd"

    • 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:
      "2021-04-01"

    • ignore_synonyms
      Typ: boolean | null

      sehr ähnliche Keywords ignorieren
      Optionales Feld
      bei true werden nur Kern-Keywords zurückgegeben, alle sehr ähnlichen Keywords werden ausgeschlossen;
      Standardwert: false

    • item_types
      Typ: array string[] | null

      Ergebnisse nach Elementtyp anzeigen
      Optionales Feld
      gibt den Typ der in der Antwort enthaltenen Suchergebnisse an;
      Hinweis: Enthält das Array item_types andere Elementtypen als organic, werden die Ergebnisse nach dem ersten Elementtyp im Array geordnet;
      mögliche Werte:
      ["organic", "paid", "featured_snippet", "local_pack"]
      Standardwert:
      ["organic", "paid"]

    • language_code
      Typ: string | null

      Sprachcode
      Wenn Sie dieses Feld verwenden, müssen Sie language_name nicht angeben
      Die Liste der verfügbaren Sprachen mit language_code erhalten Sie durch eine separate Anfrage an
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      Lassen Sie dieses Feld weg, um Ergebnisse für alle verfügbaren Sprachen zu erhalten
      Beispiel:
      en

    • language_name
      Typ: string | null

      vollständiger Name der Sprache
      Wenn Sie dieses Feld verwenden, müssen Sie language_code nicht angeben
      Die Liste der verfügbaren Sprachen mit language_name erhalten Sie durch eine separate Anfrage an
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      Lassen Sie dieses Feld weg, um Ergebnisse für alle verfügbaren Sprachen zu erhalten
      Beispiel:
      English

    • location_code
      Typ: integer | null

      Standortcode
      Wenn Sie dieses Feld verwenden, müssen Sie location_name nicht angeben
      Die Liste der verfügbaren Standorte mit location_code erhalten Sie durch eine separate Anfrage an
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      Lassen Sie dieses Feld weg, um Ergebnisse für alle verfügbaren Standorte zu erhalten
      Beispiel:
      2840

    • location_name
      Typ: string | null

      vollständiger Name des Standorts
      Wenn Sie dieses Feld verwenden, müssen Sie location_code nicht angeben
      Die Liste der verfügbaren Standorte mit location_name erhalten Sie durch eine separate Anfrage an
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      Lassen Sie dieses Feld weg, um Ergebnisse für alle verfügbaren Standorte zu erhalten
      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

    • targets
      Typ: array string[]

      Ziel-Domains und Subdomains
      Pflichtfeld
      In diesem Feld können Sie Domains und Subdomains angeben;
      Domains und Subdomains geben Sie ohne https:// und www. an;
      Sie können bis zu 1000 Domains oder Subdomains festlegen

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

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

            Array von Elementen mit relevanten Traffic-Schätzdaten

            • metrics
              Typ: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo

              Traffic-Daten zur angegebenen Domain

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

                Traffic-Daten aus den Featured-Snippet-Ergebnissen in der Google SERP

                • count
                  Typ: integer | null Format: int64

                  Gesamtzahl der organischen SERPs, die die Domain enthalten

                • etv
                  Typ: number | null

                  geschätztes Traffic-Volumen
                  geschätzter organischer monatlicher Traffic zur Domain
                  berechnet als Produkt aus CTR (Klickrate) und Suchvolumen aller Keywords, für die die Domain rankt
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                • month
                  Typ: integer | null

                  Monat, für den die Daten bereitgestellt werden

                • year
                  Typ: integer | null

                  Jahr, für das die Daten bereitgestellt werden

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

                Traffic-Daten aus den Local-Pack-Ergebnissen in SERP

                • count
                  Typ: integer | null Format: int64

                  Gesamtzahl der organischen SERPs, die die Domain enthalten

                • etv
                  Typ: number | null

                  geschätztes Traffic-Volumen
                  geschätzter organischer monatlicher Traffic zur Domain
                  berechnet als Produkt aus CTR (Klickrate) und Suchvolumen aller Keywords, für die die Domain rankt
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                • month
                  Typ: integer | null

                  Monat, für den die Daten bereitgestellt werden

                • year
                  Typ: integer | null

                  Jahr, für das die Daten bereitgestellt werden

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

                Traffic-Daten aus der organischen Suche

                • count
                  Typ: integer | null Format: int64

                  Gesamtzahl der organischen SERPs, die die Domain enthalten

                • etv
                  Typ: number | null

                  geschätztes Traffic-Volumen
                  geschätzter organischer monatlicher Traffic zur Domain
                  berechnet als Produkt aus CTR (Klickrate) und Suchvolumen aller Keywords, für die die Domain rankt
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                • month
                  Typ: integer | null

                  Monat, für den die Daten bereitgestellt werden

                • year
                  Typ: integer | null

                  Jahr, für das die Daten bereitgestellt werden

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

                Traffic-Daten aus der bezahlten Suche

                • count
                  Typ: integer | null Format: int64

                  Gesamtzahl der organischen SERPs, die die Domain enthalten

                • etv
                  Typ: number | null

                  geschätztes Traffic-Volumen
                  geschätzter organischer monatlicher Traffic zur Domain
                  berechnet als Produkt aus CTR (Klickrate) und Suchvolumen aller Keywords, für die die Domain rankt
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                • month
                  Typ: integer | null

                  Monat, für den die Daten bereitgestellt werden

                • year
                  Typ: integer | null

                  Jahr, für das die Daten bereitgestellt werden

            • se_type
              Typ: string | null

              Typ der Suchmaschine

            • target
              Typ: string | null

              Zieldomain in einem POST-Array

          • items_count
            Typ: integer | null Format: int64

            die Anzahl der im Array items zurückgegebenen Ergebnisse

          • 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

          • se_type
            Typ: string | null

            Typ der Suchmaschine

          • total_count
            Typ: integer | null Format: int64

            Gesamtmenge der für Ihre Anfrage relevanten Ergebnisse in unserer Datenbank

        • 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/dataforseo_labs/google/historical_bulk_traffic_estimation/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "dataforseo.com",
      "cnn.com",
      "forbes.com"
    ],
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29",
    "item_types": [
      "organic",
      "paid"
    ]
  }
]'
{
  "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": [
        {
          "se_type": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "target": null,
              "metrics": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Historical Bulk Traffic Estimation