v0.2.0-beta

OpenAPI 3.1.0

SERP-Wettbewerber

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

post/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live

SERP-Wettbewerber

Die Domains, die bei einer Reihe von keywords neben Ihnen ranken, samt der Anzahl gemeinsamer Keywords. Gibt se_type, seed_keywords, total_count, items_count und items zurück. 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. ⚠️ Dies sind Such-Wettbewerber, bestimmt durch gemeinsame Rankings. Das Linkgraph-Äquivalent ist post_dataforseo_backlinks_competitors_live, und die beiden Listen stimmen oft nicht überein – was selbst aufschlussreich ist.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.0192.
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, match, not_match, ilike, not_ilike, like, not_like
  Mit dem Operator % können Sie bei like und not_like, sowie ilike und not_ilike beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen
  Beispiel:
  ["median_position","in",[1,10]]
  
  [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]
  
  [["domain","not_like","%wikipedia.org%"], "and", [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
  Weitere Informationen zu Filtern finden Sie unter Dataforseo Labs - Filters oder in dieser Help-Center-Anleitung
  
  Leeres Objekt
- include_subdomains
  Typ: boolean | null
  
  Gibt an, ob Subdomains in die Suche einbezogen werden
  Optionales Feld
  bei false werden Subdomains ignoriert
  Standardwert: true
- item_types
  Typ: array string[] | null
  
  Typ der Suchergebnisse
  gibt den Typ der in der Antwort enthaltenen Suchergebnisse an
  Optionales Feld
  
  mögliche Werte:
  ["organic", "paid", "featured_snippet", "local_pack"]
  Standardwert:
  ["organic", "paid"]
- keywords
  Typ: array string[]
  
  Keywords-Array
  Pflichtfeld
  die Ergebnisse basieren auf den Keywords, die Sie in diesem Array angeben
  UTF-8-Kodierung;
  die Keywords werden in Kleinbuchstaben umgewandelt;
  Sie können maximal 200 Keywords angeben
  
  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 | null
  
  Eindeutiger Sprachbezeichner
  Pflichtfeld, wenn nicht angegeben language_name
  Hinweis: Es muss entweder language_name oder language_code angegeben werden
  Die Liste der verfügbaren Sprachen mit ihren language_code-Parametern erhalten Sie durch eine separate Anfrage an die
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  Beispiel:
  en
- language_name
  Typ: string
  
  Vollständiger Name der Sprache
  Pflichtfeld, wenn nicht angegeben language_code
  Hinweis: Es muss entweder language_name oder language_code angegeben werden
  Die Liste der verfügbaren Sprachen mit ihren language_name-Parametern erhalten Sie durch eine separate Anfrage an die
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  Beispiel:
  English
- limit
  Typ: integer | null
  
  maximale Anzahl der zurückgegebenen Domains
  Optionales Feld
  Standardwert: 100
  Höchstwert: 1000
- location_code
  Typ: integer
  
  Eindeutiger Standortbezeichner
  Pflichtfeld, wenn nicht angegeben location_name
  Hinweis: Es muss entweder location_name oder location_code angegeben werden
  Die Liste der verfügbaren Standorte mit ihren location_code-Parametern erhalten Sie durch eine separate Anfrage an die
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  Beispiel:
  2840
- location_name
  Typ: string
  
  Vollständiger Name des Standorts
  Pflichtfeld, wenn nicht angegeben location_code
  Hinweis: Es muss entweder location_name oder location_code angegeben werden
  Die Liste der verfügbaren Standorte mit location_name-Parametern erhalten Sie durch eine separate Anfrage an die
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  Beispiel:
  United Kingdom
- offset
  Typ: integer | null
  
  Offset im Ergebnis-Array der zurückgegebenen Domains
  Optionales Feld
  Standardwert: 0
  Wenn Sie den Wert 10 angeben, werden die ersten zehn Domains im Ergebnis-Array ausgelassen und die Daten für die nachfolgenden Domains 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
  das Komma wird als Trennzeichen verwendet
  Beispiel:
  ["avg_position,asc"]
  Standardregel:
  ["rating,desc"]
  Beachten Sie, dass Sie pro Anfrage höchstens drei Sortierregeln festlegen können
  Mehrere Sortierregeln müssen durch ein Komma getrennt werden
  Beispiel:
  ["avg_position,asc","etv,desc"]
- 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_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
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

enthält erkannte SERP-Wettbewerber und zugehörige Daten

avg_position
Typ: number | null Format: float

die durchschnittliche Position der Domain für die angegebenen Keywords
das arithmetische Mittel der Werte im Array keywords_positions

domain
Typ: string | null

Domainname des erkannten SERP-Wettbewerbers

etv
Typ: number | null

geschätztes Traffic-Volumen
stellt den geschätzten monatlichen Traffic dar, den die angegebenen Keywords auf die Website bringen
berechnet als Summe der Produkte aus den Suchvolumenwerten der angegebenen Keywords und den CTR-Werten (Click-Through-Rate) an bestimmten SERP-Positionen
mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel

keywords_count
Typ: integer | null Format: int64

die Anzahl der angegebenen Keywords, für die die Domain Positionen in SERPs hat

keywords_positions
Typ: object | null

Keyword-Positionen
SERP-Positionen, die die zugehörige Domain für die angegebenen Keywords in SERP einnimmt

propertyName
Typ: array (integer | null)[] | null
median_position
Typ: number | null

die mittlere Position der Domain für die angegebenen Keywords
der Median der Werte im Array keywords_positions

rating
Typ: number | null

der Abstand zwischen den maximal möglichen und den tatsächlichen Keyword-Positionen
stellt die relative Sichtbarkeitsrate der Domain in SERP für die angegebenen Keywords dar
berechnet als Summe(100-keywords_positions)

relevant_serp_items
Typ: integer | null

die Anzahl der für die Domain relevanten SERP-Elemente
stellt die Anzahl der Suchergebnisse in SERP dar, die für die angegebenen Keywords für die Domain relevant sind

se_type
Typ: string | null

Typ der Suchmaschine

visibility
Typ: number | null

SERP-Sichtbarkeitsrate
stellt die Sichtbarkeitsrate der Website basierend auf den SERP-Positionen der angegebenen Keywords dar
Keywords mit Positionen im Bereich von 1 bis 10 erhalten den Sichtbarkeitsindex von 1 bis 0,1
Keywords mit Positionen im Bereich von 11 bis 20 haben den festen Sichtbarkeitsindex 0,05
Keywords mit Positionen von 20 bis 100 haben den Sichtbarkeitsindex 0

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

seed_keywords
Typ: array (string | null)[] | null

in der Anfrage angegebene Keywords
das Keyword wird mit dekodiertem %## zurückgegeben (das Pluszeichen '+' wird zu einem Leerzeichen dekodiert)

total_count
Typ: integer | null Format: int64

die 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

post/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "limit": 5
  }
]'

Schema anzeigen

{
  "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,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

SERP-Wettbewerber

AuthentifizierungRequired

DataForSEO

SERP-Wettbewerber

Preisreferenz