v0.2.0-beta

OpenAPI 3.1.0

Domain-Intersection

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

Domain-Intersection

Die Domains, die auf mehrere Ziele gleichzeitig verlinken. ⚠️ targets ist hier ein nach Position adressiertes Objekt – {"1": "a.com", "2": "b.com"} – nicht das Array, das die Bulk-Endpunkte erwarten. exclude_targets entfernt Websites aus dem Vergleich. Jede Zeile enthält domain_intersection und eine summary pro Ziel. Damit finden Sie heraus, wer auf Ihre Wettbewerber, aber nicht auf Sie verlinkt. Das Seitenebene-Äquivalent ist post_dataforseo_backlinks_page_intersection_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_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
 
 legt fest, welche Backlinks zurückgegeben und gezählt werden
 Optionales Feld
 Mit diesem Feld wählen Sie, welche Backlinks zurückgegeben und für aggregierte Metriken Ihrer targets 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 Backlinks von Subdomains des target ausgeschlossen werden
 Optionales Feld
 bei false werden Backlinks von Subdomains des target ausgelassen und Sie erhalten dieselbe Domain nicht in der Antwort;
 Standardwert: true
- exclude_targets
 Typ: array string[] | null
 
 Domains, Subdomains oder Webseiten, die Sie ausschließen möchten
 Optionales Feld
 Sie können bis zu 10 Domains, Subdomains oder Webseiten angeben
 bei Verwendung dieses Arrays enthalten die Ergebnisse die verweisenden Domains, die auf targets verweisen, aber nicht auf exclude_targets
 Beispiel:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- 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, ilike, not_ilike, match, not_match
 Mit dem Operator % in like und not_like können Sie beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen
 Beispiel:
 ["1.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.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 zu den targets in die Ergebnisse einbezogen werden
 Optionales Feld
 bei true enthalten die Ergebnisse Daten zu indirekten Links, die auf eine Seite verweisen, die entweder auf ein Ziel weiterleitet oder auf eine kanonische Seite verweist
 bei false 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
- intersection_mode
 Typ: string | null
 
 Gibt an, ob Backlinks geschnitten werden
 Optionales Feld
 Mit diesem Feld schneiden oder führen Sie Ergebnisse für die angegebenen Domains zusammen
 mögliche Werte: all, partial
 all – die Ergebnisse basieren auf allen Backlinks;
 partial – die Ergebnisse basieren nur auf den sich überschneidenden Backlinks;
 Standardwert: all
- limit
 Typ: integer | null
 
 maximale Anzahl der zurückgegebenen Ergebnisse
 Optionales Feld
 Standardwert: 100
 Höchstwert: 1000
- offset
 Typ: integer | null
 
 Offset im Array der zurückgegebenen Ergebnisse
 Optionales Feld
 Standardwert: 0
 bei 10 werden die ersten zehn Backlinks im Ergebnisarray übersprungen und die Daten für die nachfolgenden Backlinks 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
- targets
 Typ: object | null
 
 Domains, Subdomains oder Webseiten, für die Links abgerufen werden
 Pflichtfeld
 Sie können bis zu 20 Domains, Subdomains oder Webseiten angeben
 eine Domain oder Subdomain ohne https:// und www.
 eine Seite als absolute URL (einschließlich http:// oder https://)
 Beispiel:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Typ: string | null

Antworten

200
Typ: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveResponseInfo
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_BacklinksDomainIntersectionLiveTaskInfo
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 Domains, die auf alle targets aus dem POST-Array verlinken

domain_intersection
Typ: object | null

enthält Daten zu Domains, die auf die im POST-Array angegebenen entsprechenden Ziele verlinken
die Daten werden in separaten Objekten bereitgestellt, die den im Objekt targets angegebenen Domains, Subdomains oder Seiten entsprechen

propertyName
Typ: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
Typ: integer | null Format: int64

gibt die Anzahl der Backlinks an

backlinks_spam_score
Typ: integer | null Format: int64

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

broken_backlinks
Typ: integer | null Format: int64

Anzahl defekter Backlinks

broken_pages
Typ: integer | null

Anzahl defekter Seiten

first_seen
Typ: string | null

Datum und Uhrzeit, an dem unser Crawler den Backlink von diesem target 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 diesem target 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:
2019-11-15 12:57:46 +00:00

rank
Typ: integer | null

Rank, der vom target aus dem POST-Array referenziert wird
gibt den Rank an, den die verweisende Domain (target oben) Ihrem Ziel aus dem POST-Array zuweist;
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

Anzahl verweisender Domains

referring_domains_nofollow
Typ: integer | null Format: int64

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

referring_ips
Typ: integer | null Format: int64

Anzahl verweisender IP-Adressen

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

Integer numbers.

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

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

Integer numbers.

referring_links_semantic_locations
Typ: object | null

semantische Positionen der verweisenden Links
gibt semantische HTML-Elemente an, in denen sich die verweisenden Links befinden, sowie die Linkanzahl pro semantischer Position
die vollständige Liste der semantischen Elemente finden Sie hier

propertyName
Typ: integer | null

Integer numbers.

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

Integer numbers.

referring_links_types
Typ: object | null

Typen der verweisenden 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

Integer numbers.

referring_main_domains
Typ: integer | null Format: int64

Anzahl verweisender Hauptdomains

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 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

target
Typ: string | null

Domain, die auf das entsprechende Ziel aus dem POST-Array verlinkt

type
Typ: string | null

Elementtyp

summary
Typ: object | null · Response36Afe1097B20_IntersectionSummaryInfo

enthält die Zusammenfassung der Domain-Überschneidungen

intersections_count
Typ: integer | null Format: int64

Gesamtzahl der Überschneidungen

items_count
Typ: integer | null Format: int64

die Anzahl der im Array items zurückgegebenen Ergebnisse

targets
Typ: object | null

Zieldomains, Subdomains oder Webseiten in einem POST-Array

propertyName
Typ: string | null
total_count
Typ: integer | null Format: int64

Gesamtzahl der für Ihre 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/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": true
  }
]'

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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Domain-Intersection

AuthentifizierungRequired

DataForSEO

Domain-Intersection

Preisreferenz