v0.2.0-beta

OpenAPI 3.1.0

Seiten-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/page_intersection/live

Seiten-Intersection

Die Seiten, die auf mehrere Ziel-URLs gleichzeitig verlinken, statt der Domains. ⚠️ targets ist ein nach Position adressiertes Objekt und erwartet vollständige URLs, keine reinen Domains. Jede Zeile enthält page_intersection und eine summary pro Ziel. Das Domainebene-Äquivalent ist post_dataforseo_backlinks_domain_intersection_live, zu dem Sie zuerst greifen sollten.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.033.
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
 
 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 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 das Ergebnis einbezogen
 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 Seiten, 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.rank",">","80"]
 
 [["2.page_from_rank",">","55"], "and", ["1.original","=","true"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]
 
 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 der targets 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:
 attributes
 domain_from_platform_type
 
 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 URLs 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 Backlinks
 Optionales Feld
 
 Standardwert: 100
 Höchstwert: 1000
- 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
- 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
- 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_BacklinksPageIntersectionLiveResponseInfo
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_BacklinksPageIntersectionLiveTaskInfo
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 relevante Daten zu Backlinks und verweisenden Domains

page_intersection
Typ: object | null

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

propertyName
Typ: array (object | null)[] | null
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
gibt den Rank der Domain zu dem Zeitpunkt an, an dem unser Crawler den Backlink zuletzt gesehen hat;
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

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

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

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

summary
Typ: object | null · Response36Afe1097B20_IntersectionSummaryInfo

enthält die Zusammenfassung der Seiten-Ü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

targets aus einem POST-Array

propertyName
Typ: string | null
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/page_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        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": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Seiten-Intersection

AuthentifizierungRequired

DataForSEO

Seiten-Intersection

Preisreferenz