v0.2.0-beta

OpenAPI 3.1.0

Verweisende Domains

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/backlinks/referring_domains/live

Verweisende Domains

Die Domains, die auf ein target verlinken, eine Zeile pro Domain mit domain, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks und broken_pages. Verweisende Domains zählen mehr als die reine Backlink-Anzahl, denn tausend Links von einer Domain sind eine Beziehung. Für die einzelnen Links verwenden Sie post_dataforseo_backlinks_backlinks_live; um weiter auf Netzwerkbetreiber zu verdichten, post_dataforseo_backlinks_referring_networks_live.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.0276.
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)[]
- backlinks_filters
  Typ: array (object | null)[] | null
  
  Filtert die Backlinks Ihres target
  Optionales Feld
  Mit diesem Feld filtern Sie die initialen Backlinks, die in den Datensatz für aggregierte Metriken Ihres target aufgenommen werden
  Sie können die Backlinks nach allen Feldern filtern, die in der Antwort von diesem Endpunkt verfügbar sind
  mit diesem Parameter können Sie nur Dofollow-Backlinks in die Antwort aufnehmen und einen flexiblen Backlink-Datensatz für die Metrikberechnung erstellen
  Beispiel:
  "backlinks_filters": ["dofollow", "=", true]
  
  Leeres Objekt
- backlinks_status_type
  Typ: string | null
  
  festlegen, welche Backlinks zurückgegeben und gezählt werden
  optionales Feld
  Mit diesem Feld können Sie auswählen, welche Backlinks zurückgegeben und für aggregierte Metriken Ihres target verwendet werden;
  mögliche Werte:
  all - alle Backlinks werden zurückgegeben und gezählt;
  live - Backlinks, die bei der letzten Prüfung gefunden wurden, werden zurückgegeben und gezählt;
  lost - verlorene Backlinks werden zurückgegeben und gezählt;
  
  Standardwert: live
- exclude_internal_backlinks
  Typ: boolean | null
  
  gibt an, ob die Backlinks von Subdomains des target ausgeschlossen werden
  optionales Feld
  Wenn auf false gesetzt, werden die Backlinks von Subdomains des target ausgelassen und Sie erhalten nicht dieselbe Domain in der Antwort;
  Standardwert: true
- filters
  Typ: array (object | null)[] | null
  
  Array der Filterparameter für Ergebnisse
  Optionales Feld
  Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter)
  Zwischen den Bedingungen setzen Sie einen logischen Operator and oder or
  Die folgenden Operatoren werden unterstützt:
  regex, not_regex, =, <>, in, not_in, like, not_like, match, not_match
  Mit dem Operator % in like und not_like können Sie beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen
  Beispiel:
  ["referring_pages",">","1"]
  
  [["referring_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["domain","like","%dataforseo.com%"],"or",["referring_domains",">","10"]]]
  
  Die vollständige Liste der möglichen Filter finden Sie hier.
  
  Leeres Objekt
- include_indirect_links
  Typ: boolean | null
  
  gibt an, ob indirekte Links zum target in die Ergebnisse aufgenommen werden
  optionales Feld
  Wenn auf true gesetzt, enthalten die Ergebnisse Daten zu indirekten Links, die auf eine Seite verweisen, die entweder zum Ziel weiterleitet oder auf eine kanonische Seite verweist
  Wenn auf false gesetzt, werden indirekte Links ignoriert
  Standardwert: true
- include_subdomains
  Typ: boolean | null
  
  Gibt an, ob die Subdomains des target in die Suche einbezogen werden
  Optionales Feld
  bei false werden Subdomains ignoriert
  Standardwert: true
- internal_list_limit
  Typ: integer | null
  
  maximale Anzahl der Elemente in internen Arrays
  Optionales Feld
  Mit diesem Feld begrenzen Sie die Anzahl der Elemente in den folgenden Arrays:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  Standardwert: 10
  Höchstwert: 1000
- limit
  Typ: integer | null
  
  maximale Anzahl der zurückgegebenen Domains
  Optionales Feld
  Standardwert: 100
  Höchstwert: 1000
- offset
  Typ: integer | null
  
  Offset im Ergebnisarray der zurückgegebenen Domains
  Optionales Feld
  Standardwert: 0
  bei 10 werden die ersten zehn Domains im Ergebnisarray übersprungen und die Daten für die nachfolgenden Seiten ausgegeben
- order_by
  Typ: array string[] | null
  
  Sortierregeln für die Ergebnisse
  Optionales Feld
  Zum Sortieren der Ergebnisse können Sie dieselben Werte wie im Array filters verwenden
  mögliche Sortierarten:
  asc – Ergebnisse werden aufsteigend sortiert
  desc – Ergebnisse werden absteigend sortiert
  Sortierart und -richtung werden durch ein Komma getrennt
  Beispiel:
  ["backlinks,desc"]
  Hinweis: Pro Anfrage sind höchstens drei Sortierregeln möglich
  Mehrere Sortierregeln werden durch ein Komma getrennt
  Beispiel:
  ["backlinks,desc","rank,asc"]
- rank_scale
  Typ: string | null
  
  definiert die Skala zur Berechnung und Anzeige der Werte rank, domain_from_rank und page_from_rank
  Optionales Feld
  
  Mit diesem Parameter wählen Sie, ob Rangwerte auf einer Skala von 0–100 oder 0–1000 dargestellt werden
  
  mögliche Werte:
  one_hundred — Rangwerte werden auf einer Skala von 0–100 angezeigt
  one_thousand — Rangwerte werden auf einer Skala von 0–1000 angezeigt
  
  Standardwert: one_thousand
  
  Weitere Informationen zur Funktionsweise dieses Parameters und zur Berechnung der Ranking-Metriken finden Sie in diesem Help-Center-Artikel
- 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, Subdomain oder Webseite, für die verweisende Domains abgerufen werden
  Pflichtfeld
  eine Domain oder Subdomain ohne https:// und www.
  eine Seite als absolute URL (einschließlich http:// oder https://)

Antworten

200
Typ: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveResponseInfo
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_BacklinksReferringDomainsLiveTaskInfo
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 der Einträge

backlinks
Typ: integer | null Format: int64

gibt die Anzahl der Backlinks an, die auf das target verweisen

backlinks_spam_score
Typ: integer | null Format: int64

durchschnittlicher Spam-Score aller Backlinks, die auf die Domain verweisen
Weitere Informationen zur Berechnung dieses Werts finden Sie auf dieser Help-Center-Seite

broken_backlinks
Typ: integer | null Format: int64

Anzahl defekter Backlinks
Anzahl defekter Backlinks, die auf die Domain verweisen

broken_pages
Typ: integer | null

Anzahl defekter Seiten
Anzahl der Seiten, auf die Backlinks verweisen und die mit den Statuscodes 4xx oder 5xx antworten

domain
Typ: string | null

verweisende Domain

first_seen
Typ: string | null

Datum und Uhrzeit, an dem unser Crawler den Backlink zum ersten Mal gefunden hat
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

lost_date
Typ: string | null

Datum und Uhrzeit, an dem der letzte Backlink von dieser Domain verloren ging
gibt Datum und Uhrzeit an, an dem unser Crawler die Seite besucht hat und sie mit dem Statuscode 4xx oder 5xx geantwortet hat oder der letzte Backlink entfernt wurde
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2017-01-24 13:20:59 +00:00

rank
Typ: integer | null

Domain-Rank
Rank-Volumen, das eine verweisende Website an das target weitergibt
rank wird anhand der Methode für das Node-Ranking in einer verknüpften Datenbank berechnet – ein Prinzip aus dem ursprünglichen Google-PageRank-Algorithmus
Weitere Informationen zu diesem Wert und seiner Berechnung finden Sie in diesem Help-Center-Artikel

referring_domains
Typ: integer | null Format: int64

gibt die Anzahl verweisender Domains an
beachten Sie, dass wir Hauptdomains (Root-Domains wie example.com) und ihre Subdomains (z. B. blog.example.com) für diesen Wert getrennt zählen

referring_domains_nofollow
Typ: integer | null Format: int64

Anzahl der Domains, die mindestens einen nofollow-Link auf das target setzen

referring_ips
Typ: integer | null Format: int64

Anzahl verweisender IP-Adressen
Anzahl der IP-Adressen, die auf diese Seite verweisen

referring_links_attributes
Typ: object | null

Link-Attribute der verweisenden Links
gibt die Link-Attribute der verweisenden Links und die Linkanzahl pro Attribut an

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_countries
Typ: object | null

ISO-Ländercodes der verweisenden Links
gibt die ISO-Ländercodes der Domains an, auf denen sich die verweisenden Links befinden, und die Linkanzahl pro Land

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Typ: object | null

Typen verweisender Plattformen
gibt die Typen verweisender Plattformen und die Linkanzahl pro Plattform an

mögliche Werte: cms, blogs, ecommerce, message-boards, wikis, news, organization

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Typ: object | null

semantische Positionen der verweisenden Links
gibt semantische HTML-Elemente an, in denen sich die verweisenden Links befinden, und die Linkanzahl pro semantischer Position

die vollständige Liste der semantischen Elemente finden Sie hier
Beispiele:
article, section, summary

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_tld
Typ: object | null

Top-Level-Domains der verweisenden Links
enthält Top-Level-Domains und die Anzahl der verweisenden Links pro Domain

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_types
Typ: object | null

Typen verweisender Links
gibt die Typen der verweisenden Links und die Linkanzahl pro Typ an
mögliche Werte:
anchor, image, link, meta, canonical, alternate, redirect

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_main_domains
Typ: integer | null Format: int64

gibt die Anzahl verweisender Hauptdomains an
die Anzahl der primären (Root-)Domains, die auf Ihr Ziel verweisen

referring_main_domains_nofollow
Typ: integer | null Format: int64

Anzahl der Hauptdomains, die mindestens einen nofollow-Link auf das target setzen

referring_pages
Typ: integer | null Format: int64

gibt die Anzahl der Seiten an, die auf das angegebene target verweisen

referring_pages_nofollow
Typ: integer | null Format: int64

Anzahl verweisender Seiten, die mindestens einen nofollow-Link auf das target setzen

referring_subnets
Typ: integer | null Format: int64

Anzahl verweisender Subnetze

type
Typ: string | null

Elementtyp

items_count
Typ: integer | null Format: int64

Anzahl der Elemente im Array items

target
Typ: string | null

target in einem POST-Array

total_count
Typ: integer | null Format: int64

Gesamtzahl relevanter Elemente in der Datenbank
Gesamtzahl der Hauptdomains, die auf Ihr Ziel verweisen;
example.com und blog.example.com werden als eine verweisende Domain gezählt

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/backlinks/referring_domains/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "backlinko.com",
    "limit": 5,
    "order_by": [
      "rank,desc"
    ],
    "exclude_internal_backlinks": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "filters": [
      "backlinks",
      ">",
      100
    ]
  }
]'

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": [
        {
          "target": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Verweisende Domains

AuthentifizierungRequired

DataForSEO

Verweisende Domains

Preisreferenz