v0.2.0-beta

OpenAPI 3.1.0

Backlinks

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

Backlinks

Die einzelnen eingehenden Links zu einem target, eine Zeile pro Link. Gibt total_count, items_count, items und ein search_after_token zum Blättern zurück – verwenden Sie dieses statt offset, sobald die ersten Seiten überschritten sind. mode und custom_mode steuern die Gruppierung, backlinks_status_type wählt live, lost oder all. Für Anzahlen statt Zeilen verwenden Sie post_dataforseo_backlinks_summary_live, für die gruppierten verlinkenden Domains post_dataforseo_backlinks_referring_domains_live.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.06.
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_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
- custom_mode
  Typ: object | null
  
  Gruppierungstyp für detaillierte Ergebnisse
  Optionales Feld
  mit diesem Objekt legen Sie eine bestimmte Anzahl Backlinks pro field fest
  bei custom_mode wird mode ignoriert
  Beispiel:
  "custom_mode": {"field": "domain", "value": 100}
  
  propertyName
  Typ: object | null
- exclude_internal_backlinks
  Typ: boolean | null
  
  Gibt an, ob interne Backlinks von Subdomains zum target aus den Ergebnissen ausgeschlossen werden
  Optionales Feld
  bei true enthalten die Ergebnisse keine Daten zu internen Backlinks von Subdomains derselben Domain wie target
  bei false werden interne Links in die Ergebnisse einbezogen
  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:
  =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
  Mit dem Operator % in like und not_like können Sie beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen
  Beispiel:
  ["rank",">","80"]
  
  [["page_from_rank",">","55"], "and", ["dofollow","=",true]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]
  
  Die vollständige Liste der möglichen Filter finden Sie hier.
  
  Leeres Objekt
- 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
- limit
  Typ: integer | null
  
  maximale Anzahl der zurückgegebenen Backlinks
  Optionales Feld
  
  Standardwert: 100
  Höchstwert: 1000
- mode
  Typ: string | null
  
  Gruppierungstyp für Ergebnisse
  Optionales Feld
  mögliche Gruppierungstypen:
  as_is – gibt alle Backlinks zurück
  one_per_domain – gibt einen Backlink pro Domain zurück
  one_per_anchor – gibt einen Backlink pro Anker zurück
  
  Standardwert: as_is
- offset
  Typ: integer | null
  
  Offset im Ergebnisarray der zurückgegebenen Backlinks
  Optionales Feld
  
  Standardwert: 0
  bei 10 werden die ersten zehn Backlinks im Ergebnisarray übersprungen und die Daten für die nachfolgenden Backlinks ausgegeben;
  Hinweis: Der Höchstwert ist 20,000; wenn Sie mehr Ergebnisse überspringen möchten, verwenden Sie search_after_token
- 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:
  ["rank,desc"]
  Hinweis: Pro Anfrage sind höchstens drei Sortierregeln möglich
  Mehrere Sortierregeln werden durch ein Komma getrennt
  Beispiel:
  ["domain_from_rank,desc","page_from_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
- search_after_token
  Typ: string | null
  
  Token für nachfolgende Anfragen
  Optionales Feld
  wird im identischen Feld der Antwort auf jede Anfrage bereitgestellt;
  mit diesem Parameter vermeiden Sie Timeouts beim Abruf von über 20,000 Ergebnissen in einer einzelnen Anfrage;
  mit dem eindeutigen search_after_token-Wert aus dem Antwortarray erhalten Sie die nachfolgenden Ergebnisse der ursprünglichen Aufgabe;
  search_after_token-Werte sind für jede nachfolgende Aufgabe eindeutig;
  Hinweis: Wenn search_after_token in der Anfrage angegeben ist, müssen alle anderen Parameter mit der vorherigen Anfrage identisch sein
- 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 Backlinks 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_BacklinksBacklinksLiveResponseInfo
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_BacklinksBacklinksLiveTaskInfo
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

custom_mode
Typ: object | null

benutzerdefinierter Modus, angegeben in einem POST-Array

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

enthält relevante Daten zu Backlinks und verweisenden Domains

alt
Typ: string | null

Alternativtext des Bildes
dieses Feld ist null, wenn der type des Backlinks nicht image ist

anchor
Typ: string | null

Ankertext des Backlinks

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

Link-Attribute der verweisenden Links
Beispiel:
nofollow

backlink_spam_score
Typ: integer | null

Spam-Score des Backlinks
Weitere Informationen zur Berechnung dieses Werts finden Sie auf dieser Help-Center-Seite

dofollow
Typ: boolean | null

gibt an, ob der Backlink dofollow ist
wenn false, ist der Backlink nofollow

domain_from
Typ: string | null

Domain, die auf die Zieldomain oder -webseite verweist

domain_from_country
Typ: string | null

ISO-Ländercode der verweisenden Domain

domain_from_ip
Typ: string | null

IP-Adresse der verweisenden Domain

domain_from_is_ip
Typ: boolean | null

gibt an, ob die Domain eine IP ist
wenn true, fungiert die Domain als IP-Adresse und hat keinen Domainnamen

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

Plattformtypen der verweisenden Domain

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

domain_from_rank
Typ: integer | null

Domain-Rank der verweisenden Domain
domain_from_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

domain_to
Typ: string | null

Domain, auf die der Backlink verweist

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

group_count
Typ: integer | null Format: int64

gibt die Gesamtzahl der Backlinks von dieser Domain an
wenn mode beispielsweise auf one_per_domain gesetzt ist, gibt dieses Feld die Gesamtzahl der von dieser Domain stammenden Backlinks an

image_url
Typ: string | null

URL des Bildes
die URL, die zum Bild auf der Originalressource oder im DataForSEO-Speicher führt (falls die Originalquelle nicht verfügbar ist)

indirect_link_path
Typ: array (object | null)[] | null

Pfad des indirekten Links
gibt eine URL oder eine Folge von URLs an, die zu url_to führen

status_code
Typ: integer | null

allgemeiner Statuscode
die vollständige Liste der Antwortcodes finden Sie hier
Hinweis: Wir empfehlen dringend, ein geeignetes System zur Behandlung zugehöriger Ausnahme- und Fehlerzustände zu entwerfen

type
Typ: string | null

Elementtyp

url
Typ: string | null

URL des indirekten Links

is_broken
Typ: boolean | null

gibt an, ob der Backlink defekt ist
wenn true, verweist der Backlink auf eine Seite, die mit dem Statuscode 4xx oder 5xx antwortet

is_indirect_link
Typ: boolean | null

gibt an, ob der Backlink ein indirekter Link ist
wenn true, ist der Backlink ein indirekter Link, der auf eine Seite verweist, die entweder auf url_to weiterleitet oder auf eine kanonische Seite zeigt

is_lost
Typ: boolean | null

gibt an, ob der Backlink entfernt wurde
wenn true, wurde der Backlink oder die gesamte Seite entfernt

is_new
Typ: boolean | null

gibt an, ob der Backlink neu ist
wenn true, wurde der Backlink bei der letzten Crawler-Visite auf der Seite gefunden

item_type
Typ: string | null

Linktyp
mögliche Werte:
anchor, image, meta, canonical, alternate, redirect

last_seen
Typ: string | null

jüngstes Datum, an dem unser Crawler den Backlink besucht hat
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

links_count
Typ: integer | null Format: int64

Anzahl identischer Backlinks auf der verweisenden Seite

original
Typ: boolean | null

gibt an, ob der Backlink bei der ersten Crawler-Visite auf der verweisenden Seite vorhanden war

page_from_encoding
Typ: string | null

Zeichenkodierung der verweisenden Seite
Beispiel:
utf-8

page_from_external_links
Typ: integer | null

Anzahl externer Links auf der verweisenden Seite

page_from_internal_links
Typ: integer | null

Anzahl interner Links auf der verweisenden Seite

page_from_language
Typ: string | null

Sprache der verweisenden Seite
im ISO-639-1-Format
Beispiel:
en

page_from_rank
Typ: integer | null

Seiten-Rank der verweisenden Seite
page_from_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

page_from_size
Typ: integer | null

Größe der verweisenden Seite in Bytes
Beispiel:
63357

page_from_status_code
Typ: integer | null

HTTP-Statuscode der verweisenden Seite
Beispiel:
200

page_from_title
Typ: string | null

Titel der verweisenden Seite

prev_seen
Typ: string | null

vor dem jüngsten Datum, an dem unser Crawler den Backlink besucht hat
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

rank
Typ: integer | null

Backlink-Rank
Rank, den der jeweilige Backlink 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

ranked_keywords_info
Typ: object | null · Response36Afe1097B20_RankedKeywordsInfo
page_from_keywords_count_top_10
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

page_from_keywords_count_top_100
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

page_from_keywords_count_top_3
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

semantic_location
Typ: string | null

gibt das semantische HTML-Element an, in dem der Backlink gefunden wurde
die vollständige Liste der semantischen Elemente finden Sie hier
Beispiele:
article, section, summary

text_post
Typ: string | null

Snippet nach dem Ankertext

text_pre
Typ: string | null

Snippet vor dem Ankertext

tld_from
Typ: string | null

Top-Level-Domain der verweisenden URL

type
Typ: string | null

Elementtyp

url_from
Typ: string | null

URL der Seite, auf der der Backlink gefunden wurde

url_from_https
Typ: boolean | null

gibt an, ob die verweisende URL mit HTTPS gesichert ist
wenn true, ist die verweisende URL mit HTTPS gesichert

url_to
Typ: string | null

URL, auf die der Backlink verweist

url_to_https
Typ: boolean | null

gibt an, ob die URL, auf die der Backlink verweist, mit HTTPS gesichert ist
wenn true, ist die URL mit HTTPS gesichert

url_to_redirect_target
Typ: string | null

Ziel-URL der Weiterleitung
Zielseite, auf die die Weiterleitung verweist

url_to_spam_score
Typ: integer | null

Spam-Score der referenzierten Seite
wenn der Wert null ist, hat unser Crawler die Webseite, auf die der Link verweist, noch nicht besucht;
Weitere Informationen zur Berechnung dieses Werts finden Sie auf dieser Help-Center-Seite

url_to_status_code
Typ: integer | null

Statuscode der referenzierten Seite
wenn der Wert null ist, hat unser Crawler die Webseite, auf die der Link verweist, noch nicht besucht
Beispiel:
200

items_count
Typ: integer | null Format: int64

die Anzahl der im Array items zurückgegebenen Ergebnisse

mode
Typ: string | null

Modus, angegeben in einem POST-Array

search_after_token
Typ: string | null

Token für nachfolgende Anfragen
Wenn Sie beim Festlegen einer neuen Aufgabe das eindeutige search_after_token angeben, erhalten Sie die nachfolgenden Ergebnisse der ursprünglichen Aufgabe;
search_after_token-Werte sind für jede nachfolgende Aufgabe eindeutig

target
Typ: string | null

Zieldomain in einem POST-Array

total_count
Typ: integer | null Format: int64

Gesamtzahl der für die Anfrage relevanten Ergebnisse

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "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": [
        {
          "target": null,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Backlinks

AuthentifizierungRequired

DataForSEO

Backlinks

Preisreferenz