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

Relevante Seiten

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

Relevante Seiten

​

Welche Seiten einer target-Website ihre Rankings erzielen, sortiert nach dem Traffic, den sie bringen. Paginierung mit limit, offset und offset_token; verwenden Sie das Token für Seiten nach den ersten. 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. Nutzen Sie sie, um die Seiten zu finden, die es zu verteidigen oder auszubauen gilt. Für die dahinterstehenden Keywords verwenden Sie post_dataforseo_labs_google_kw_for_site_live; für die Seiten, die Links statt Rankings erzielen, post_dataforseo_backlinks_domain_pages_summary_live.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.015.
  • 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)[]
    • filters
      Typ: array (object | null)[] | null

      Array von Parametern zum Filtern der Ergebnisse
      Optionales Feld
      Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter)
      Zwischen den Bedingungen müssen Sie einen logischen Operator and, or setzen
      folgende Operatoren werden unterstützt:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in

      Beispiel:
      ["metrics.paid.count",">",0]

      [["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]]

      [[""metrics.organic.count",">",50"],
      "and",
      [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
      Weitere Informationen zu Filtern finden Sie unter Dataforseo Labs - Filters oder in dieser Help-Center-Anleitung

      Leeres Objekt
    • historical_serp_mode
      Typ: string | null

      Datenerfassungsmodus
      Optionales Feld
      Mit diesem Feld können Sie die Ergebnisse filtern;
      mögliche Filtertypen:
      live — Metriken für SERPs zurückgeben, in denen das angegebene target aktuell Ranking-Ergebnisse hat;
      lost — Metriken für SERPs zurückgeben, in denen das angegebene target zuvor Ranking-Ergebnisse hatte, sie bei der letzten Prüfung aber nicht mehr hatte;
      all — Metriken für beide SERP-Typen zurückgeben.
      Standardwert: live

    • 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

    • include_clickstream_data
      Typ: boolean | null

      Daten aus clickstream-basierten Metriken in das Ergebnis aufnehmen oder ausschließen
      Optionales Feld
      wenn der Parameter auf true gesetzt ist, erhalten Sie die Felder clickstream_etv, clickstream_gender_distribution und clickstream_age_distribution mit Clickstream-Daten in der Antwort
      Standardwert: false
      bei aktiviertem Parameter wird der doppelte Preis für die Anfrage berechnet

      Weitere Informationen zur Berechnung clickstream-basierter Metriken finden Sie in diesem Help-Center-Artikel

    • 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; Sie können Ergebnisse nicht nach Suchresultattypen sortieren oder filtern, die nicht in der Antwort enthalten sind;

      mögliche Werte:
      ["organic", "paid", "featured_snippet", "local_pack"]
      Standardwert:
      ["organic", "paid"]

    • language_code
      Typ: string | null

      Sprachcode
      Optionales Feld
      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
      Optionales Feld
      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

    • limit
      Typ: integer | null

      maximale Anzahl der zurückgegebenen Seiten
      Optionales Feld
      Standardwert: 100
      Höchstwert: 1000

    • location_code
      Typ: integer | null

      Standortcode
      Optionales Feld
      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
      Optionales Feld
      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

    • offset
      Typ: integer | null

      Offset im Ergebnis-Array der zurückgegebenen Seiten
      Optionales Feld
      Standardwert: 0
      Wenn Sie den Wert 10 angeben, werden die ersten zehn Seiten im Ergebnis-Array ausgelassen und die Daten für die nachfolgenden Seiten bereitgestellt

    • order_by
      Typ: array string[] | null

      Sortierregeln für Ergebnisse
      Optionales Feld
      Sie können dieselben Werte wie im filters-Array verwenden, um die Ergebnisse zu sortieren
      mögliche Sortierarten:
      asc – Ergebnisse werden in aufsteigender Reihenfolge sortiert
      desc – Ergebnisse werden in absteigender Reihenfolge sortiert
      Sie legen eine Sortierart mit einem Komma fest
      Beispiel:
      ["metrics.paid.etv,asc"]
      Hinweis: Sie können pro Anfrage höchstens drei Sortierregeln festlegen
      Mehrere Sortierregeln trennen Sie mit einem Komma
      Beispiel:
      ["metrics.organic.etv,desc","metrics.paid.count,asc"]

      Standardregel:
      ["metrics.organic.count,desc"]
      Hinweis: Enthält das Array item_types andere Elementtypen als organic, werden die Ergebnisse nach dem ersten Elementtyp im Array geordnet

    • 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

    • target
      Typ: string

      Domain
      Pflichtfeld
      der Domainname der Zielwebsite
      die Domain geben Sie ohne https:// und www. an

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

            relevante Seiten und zugehörige Daten

            • metrics
              Typ: object | null

              Ranking- und Traffic-Metriken für die relevante Seite

              • propertyName
                Typ: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Typ: object | null

                  Verteilung der clickstream-basierten Metriken nach Alter
                  um Ergebnisse für dieses Feld zu erhalten, muss der Parameter include_clickstream_data auf true gesetzt sein
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                  • propertyName
                    Typ: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Typ: number | null Format: double

                  geschätztes Traffic-Volumen auf Basis von Clickstream-Daten
                  berechnet als Produkt aus Click-Through-Rate und Clickstream-Suchvolumenwerten aller Keywords, für die die Domain rankt
                  um Ergebnisse für dieses Feld zu erhalten, muss der Parameter include_clickstream_data auf true gesetzt sein
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                • clickstream_gender_distribution
                  Typ: object | null

                  Verteilung der geschätzten clickstream-basierten Metriken nach Geschlecht
                  um Ergebnisse für dieses Feld zu erhalten, muss der Parameter include_clickstream_data auf true gesetzt sein
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                  • propertyName
                    Typ: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • count
                  Typ: integer | null Format: int64

                  Gesamtzahl der organischen SERPs, die die Domain oder Subdomain enthalten

                • estimated_paid_traffic_cost
                  Typ: number | null

                  geschätzte Kosten der Umwandlung von organischem Suchtraffic in bezahlten
                  stellt die geschätzten monatlichen Kosten (USD) für Anzeigen für alle Keywords in der Kategorie dar, für die die Domain oder Subdomain rankt
                  die Metrik wird als Produkt der organischen etv- und der bezahlten cpc-Werte berechnet und gibt die Kosten an, das geschätzte monatliche organische Traffic-Volumen über PPC-Werbung in der Google-Suche zu erzielen
                  mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

                • etv
                  Typ: number | null

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

                • is_down
                  Typ: integer | null

                  Rang gesunken
                  gibt an, wie viele gerankte Elemente des angegebenen Ziels gesunken sind

                • is_lost
                  Typ: integer | null

                  verlorene gerankte Elemente
                  gibt an, wie viele gerankte Elemente des angegebenen Ziels zuvor in SERPs erschienen sind, aber bei der letzten Prüfung nicht gefunden wurden

                • is_new
                  Typ: integer | null

                  Anzahl neuer gerankter Elemente
                  gibt an, wie viele neue gerankte Elemente für das angegebene Ziel gefunden wurden

                • is_up
                  Typ: integer | null

                  Rang gestiegen
                  gibt an, wie viele gerankte Elemente des angegebenen Ziels gestiegen sind

                • pos_1
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 1 rangt

                • pos_11_20
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 11–20 rangt

                • pos_2_3
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 2–3 rangt

                • pos_21_30
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 21–30 rangt

                • pos_31_40
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 31–40 rangt

                • pos_4_10
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 4–10 rangt

                • pos_41_50
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 41–50 rangt

                • pos_51_60
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 51–60 rangt

                • pos_61_70
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 61–70 rangt

                • pos_71_80
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 71–80 rangt

                • pos_81_90
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 81–90 rangt

                • pos_91_100
                  Typ: integer | null

                  Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 91–100 rangt

            • page_address
              Typ: string | null

              absolute URL der relevanten Seite

            • se_type
              Typ: string | null

              Typ der Suchmaschine

          • 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

          • target
            Typ: string | null

            Zieldomain in einem POST-Array

          • 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/relevant_pages/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "amazon.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        0
      ]
    ],
    "limit": 3
  }
]'

{
  "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,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "page_address": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Relevant Pages