v0.2.0-beta

OpenAPI 3.1.0

Przecięcie stron

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operacje

post/v1/beta/dataforseo/backlinks/page_intersection/live

Przecięcie stron

Strony linkujące do kilku docelowych adresów URL naraz, a nie domeny. ⚠️ targets jest obiektem kluczowanym pozycją i przyjmuje pełne adresy URL, a nie same domeny. Każdy wiersz zawiera page_intersection oraz summary dla każdego celu. Odpowiednik na poziomie domen to post_dataforseo_backlinks_domain_intersection_live — po niego sięgnij najpierw.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.033.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie oferta dla konta, nie gwarantowana cena ani limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

application/json

Typ: array (object | null)[]
- backlinks_status_type
 Typ: string | null
 
 określa, które linki zwrotne zwrócić i zliczyć
 pole opcjonalne
 za pomocą tego pola możesz wybrać, które linki zwrotne zostaną zwrócone i wykorzystane do zagregowanych metryk dla Twoich targets;
 możliwe wartości:
 all — zostaną zwrócone i zliczone wszystkie linki zwrotne;
 live — zostaną zwrócone i zliczone linki zwrotne znalezione podczas ostatniej kontroli;
 lost — zostaną zwrócone i zliczone utracone linki zwrotne;
 
 wartość domyślna: live
- exclude_internal_backlinks
 Typ: boolean | null
 
 wskazuje, czy wewnętrzne linki zwrotne z subdomen do target zostaną wykluczone z wyników
 pole opcjonalne
 jeśli ustawisz true, wyniki nie będą zawierać danych o wewnętrznych linkach zwrotnych z subdomen tej samej domeny co target
 jeśli ustawisz false, linki wewnętrzne zostaną uwzględnione w wyniku
 wartość domyślna: true
- exclude_targets
 Typ: array string[] | null
 
 domeny, subdomeny lub strony internetowe, które chcesz wykluczyć
 pole opcjonalne
 możesz podać do 10 domen, subdomen lub stron internetowych
 jeśli użyjesz tej tablicy, wyniki będą zawierać strony odsyłające, które linkują do targets, ale nie linkują do exclude_targets
 przykład:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- filters
 Typ: array (object | null)[] | null
 
 tablica parametrów filtrowania wyników
 pole opcjonalne
 możesz dodać kilka filtrów jednocześnie (maksymalnie 8)
 między warunkami należy ustawić operator logiczny and, or
 obsługiwane są następujące operatory:
 regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
 operatora % możesz użyć z like i not_like, aby dopasować dowolny ciąg złożony z zera lub więcej znaków
 przykład:
 ["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%"]]]
 
 Pełna lista możliwych filtrów jest dostępna tutaj.
 
 Pusty obiekt
- include_indirect_links
 Typ: boolean | null
 
 wskazuje, czy pośrednie linki do targets zostaną uwzględnione w wynikach
 pole opcjonalne
 jeśli ustawisz true, wyniki będą zawierać dane o linkach pośrednich wskazujących na stronę, która przekierowuje do celu lub wskazuje stronę kanoniczną
 jeśli ustawisz false, linki pośrednie zostaną zignorowane
 wartość domyślna: true
- include_subdomains
 Typ: boolean | null
 
 wskazuje, czy subdomeny targets zostaną uwzględnione w wyszukiwaniu
 pole opcjonalne
 jeśli ustawisz false, subdomeny zostaną pominięte
 wartość domyślna: true
- internal_list_limit
 Typ: integer | null
 
 maksymalna liczba elementów w tablicach wewnętrznych
 pole opcjonalne
 możesz użyć tego pola, aby ograniczyć liczbę elementów w następujących tablicach:
 attributes
 domain_from_platform_type
 
 wartość domyślna: 10
 wartość maksymalna: 1000
- intersection_mode
 Typ: string | null
 
 wskazuje, czy przecinać linki zwrotne
 pole opcjonalne
 użyj tego pola, aby przeciąć lub scalić wyniki dla podanych adresów URL
 możliwe wartości: all, partial
 all — wyniki opierają się na wszystkich linkach zwrotnych;
 partial — wyniki opierają się tylko na przecinających się linkach zwrotnych;
 wartość domyślna: all
- limit
 Typ: integer | null
 
 maksymalna liczba zwracanych linków zwrotnych
 pole opcjonalne
 
 wartość domyślna: 100
 wartość maksymalna: 1000
- offset
 Typ: integer | null
 
 przesunięcie w tablicy wyników zwracanych linków zwrotnych
 pole opcjonalne
 
 wartość domyślna: 0
 jeśli podasz wartość 10, pierwsze dziesięć linków zwrotnych w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych linków zwrotnych
- order_by
 Typ: array string[] | null
 
 zasady sortowania wyników
 pole opcjonalne
 do sortowania wyników możesz użyć tych samych wartości co w tablicy filters
 możliwe typy sortowania:
 asc — wyniki zostaną posortowane rosnąco
 desc — wyniki zostaną posortowane malejąco
 typ sortowania ustawia się przecinkiem
 przykład:
 ["rank,desc"]
 pamiętaj, że w jednym żądaniu można ustawić nie więcej niż trzy zasady sortowania
 kilka zasad sortowania należy oddzielić przecinkiem
 przykład:
 ["domain_from_rank,desc","page_from_rank,asc"]
- rank_scale
 Typ: string | null
 
 określa skalę używaną do obliczania i wyświetlania wartości rank, domain_from_rank i page_from_rank
 pole opcjonalne
 
 możesz użyć tego parametru, aby wybrać, czy wartości rank są prezentowane w skali 0–100 czy 0–1000
 
 możliwe wartości:
 one_hundred — wartości rank są wyświetlane w skali 0–100
 one_thousand — wartości rank są wyświetlane w skali 0–1000
 
 wartość domyślna: one_thousand
 
 więcej o działaniu tego parametru i obliczaniu metryk rankingu znajdziesz w tym artykule Centrum pomocy
- tag
 Typ: string | null
 
 identyfikator zadania zdefiniowany przez użytkownika
 pole opcjonalne
 limit znaków: 255
 ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
 podaną wartość tag znajdziesz w obiekcie data odpowiedzi
- targets
 Typ: object | null
 
 domeny, subdomeny lub strony internetowe, dla których mają zostać pobrane linki
 pole wymagane
 możesz podać do 20 domen, subdomen lub stron internetowych
 domenę lub subdomenę należy podać bez https:// i www.
 stronę należy podać jako pełny URL (z http:// lub https://)
 przykład:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Typ: string | null

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

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

tablica zadań

Typ: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveTaskInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

propertyName
Typ: object | null
id
Typ: string | null

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

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

ścieżka URL

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

tablica wyników

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

zawiera odpowiednie dane o linkach zwrotnych i domenach odsyłających

page_intersection
Typ: object | null

zawiera dane o stronach linkujących do odpowiednich celów określonych w tablicy POST
dane są podawane w osobnych obiektach odpowiadających stronom określonym w obiekcie targets

propertyName
Typ: array (object | null)[] | null
alt
Typ: string | null

tekst alternatywny obrazu
to pole będzie miało wartość null, jeśli type linku zwrotnego nie jest obrazem

anchor
Typ: string | null

tekst kotwicy linku zwrotnego

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

atrybuty linków odsyłających
przykład:
nofollow

backlink_spam_score
Typ: integer | null

ocena spamu linku zwrotnego
więcej o sposobie obliczania tego miernika znajdziesz na tej stronie Centrum pomocy

dofollow
Typ: boolean | null

wskazuje, czy link zwrotny jest dofollow
jeśli false, link zwrotny jest nofollow

domain_from
Typ: string | null

domena odsyłająca do domeny docelowej lub strony internetowej

domain_from_country
Typ: string | null

kod kraju ISO domeny odsyłającej

domain_from_ip
Typ: string | null

adres IP domeny odsyłającej

domain_from_is_ip
Typ: boolean | null

wskazuje, czy domena jest adresem IP
jeśli true, domena działa jako adres IP i nie ma nazwy domenowej

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

typy platform domeny odsyłającej

możliwe wartości: cms, blogs, ecommerce, message-boards, wikis, news, organization

domain_from_rank
Typ: integer | null

rank domeny odsyłającej
wskazuje rank domeny w momencie, gdy nasz crawler ostatnio widział link zwrotny;
domain_from_rank jest obliczany metodą szeregowania węzłów w połączonej bazie danych — zasadą stosowaną w oryginalnym algorytmie Google PageRank
więcej o mierniku i jego obliczaniu znajdziesz w tym artykule Centrum pomocy

domain_to
Typ: string | null

domena, na którą wskazuje link zwrotny

first_seen
Typ: string | null

data i godzina, kiedy nasz crawler po raz pierwszy znalazł link zwrotny
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

group_count
Typ: integer | null Format: int64

wskazuje łączną liczbę linków zwrotnych z tej domeny
na przykład, jeśli mode ma wartość one_per_domain, pole wskaże łączną liczbę linków zwrotnych pochodzących z tej domeny

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

ścieżka linku pośredniego
wskazuje adres URL lub sekwencję adresów URL prowadzących do url_to

status_code
Typ: integer | null

ogólny kod statusu
pełną listę kodów odpowiedzi znajdziesz tutaj
Uwaga: zdecydowanie zalecamy zaprojektowanie niezbędnego systemu obsługi powiązanych wyjątków i warunków błędów

type
Typ: string | null

typ elementu

url
Typ: string | null

adres URL linku pośredniego

is_broken
Typ: boolean | null

wskazuje, czy link zwrotny jest niedziałający
jeśli true, link zwrotny wskazuje stronę odpowiadającą kodem statusu 4xx lub 5xx

is_indirect_link
Typ: boolean | null

wskazuje, czy link zwrotny jest linkiem pośrednim
jeśli true, link zwrotny jest linkiem pośrednim wskazującym stronę, która przekierowuje do url_to lub wskazuje stronę kanoniczną

is_lost
Typ: boolean | null

wskazuje, czy link zwrotny został usunięty
jeśli true, usunięto link zwrotny lub całą stronę

is_new
Typ: boolean | null

wskazuje, czy link zwrotny jest nowy
jeśli true, link zwrotny znajdował się na stronie podczas ostatniej wizyty naszego crawlera

item_type
Typ: string | null

typ linku
możliwe wartości:
anchor, image, link, meta, canonical, alternate, redirect

last_seen
Typ: string | null

najnowsza data wizyty naszego crawlera przy linku zwrotnym
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

links_count
Typ: integer | null Format: int64

liczba identycznych linków zwrotnych znalezionych na stronie odsyłającej

original
Typ: boolean | null

wskazuje, czy link zwrotny był obecny na stronie odsyłającej, gdy nasz crawler odwiedził ją po raz pierwszy

page_from_encoding
Typ: string | null

kodowanie znaków strony odsyłającej
przykład:
utf-8

page_from_external_links
Typ: integer | null

liczba linków zewnętrznych znalezionych na stronie odsyłającej

page_from_internal_links
Typ: integer | null

liczba linków wewnętrznych znalezionych na stronie odsyłającej

page_from_language
Typ: string | null

język strony odsyłającej
w formacie ISO 639-1
przykład:
en

page_from_rank
Typ: integer | null

rank strony odsyłającej
page_from_rank jest obliczany metodą szeregowania węzłów w połączonej bazie danych — zasadą stosowaną w oryginalnym algorytmie Google PageRank
więcej o mierniku i jego obliczaniu znajdziesz w tym artykule Centrum pomocy

page_from_size
Typ: integer | null

rozmiar strony odsyłającej w bajtach
przykład:
63357

page_from_status_code
Typ: integer | null

kod statusu HTTP zwrócony przez stronę odsyłającą
przykład:
200

page_from_title
Typ: string | null

tytuł strony odsyłającej

prev_seen
Typ: string | null

data poprzedzająca najnowszą wizytę naszego crawlera przy linku zwrotnym
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

rank
Typ: integer | null

rank linku zwrotnego
rank jest obliczany metodą szeregowania węzłów w połączonej bazie danych — zasadą stosowaną w oryginalnym algorytmie Google PageRank
więcej o mierniku i jego obliczaniu znajdziesz w tym artykule Centrum pomocy

semantic_location
Typ: string | null

wskazuje element semantyczny w HTML, w którym znaleziono link zwrotny
pełną listę elementów semantycznych znajdziesz tutaj
przykłady:
article, section, summary

text_post
Typ: string | null

fragment tekstu po tekście kotwicy

text_pre
Typ: string | null

fragment tekstu przed tekstem kotwicy

tld_from
Typ: string | null

domena najwyższego poziomu odsyłającego adresu URL

type
Typ: string | null

typ elementu

url_from
Typ: string | null

adres URL strony, na której znaleziono link zwrotny

url_from_https
Typ: boolean | null

wskazuje, czy odsyłający adres URL jest zabezpieczony protokołem HTTPS
jeśli true, odsyłający adres URL jest zabezpieczony protokołem HTTPS

url_to
Typ: string | null

adres URL, na który wskazuje link zwrotny

url_to_https
Typ: boolean | null

wskazuje, czy adres URL, na który wskazuje link zwrotny, jest zabezpieczony protokołem HTTPS
jeśli true, adres URL jest zabezpieczony protokołem HTTPS

url_to_redirect_target
Typ: string | null

docelowy adres URL przekierowania
strona docelowa, na którą wskazuje przekierowanie

url_to_spam_score
Typ: integer | null

ocena spamu strony, do której prowadzi link
jeśli wartość to null, nasz crawler nie odwiedził jeszcze strony, na którą wskazuje link
więcej o sposobie obliczania tego miernika znajdziesz na tej stronie Centrum pomocy

url_to_status_code
Typ: integer | null

kod statusu strony, do której prowadzi link
jeśli wartość to null, nasz crawler nie odwiedził jeszcze strony, na którą wskazuje link
przykład:
200

summary
Typ: object | null · Response36Afe1097B20_IntersectionSummaryInfo

zawiera podsumowanie przecięć stron

intersections_count
Typ: integer | null Format: int64

łączna liczba przecięć

items_count
Typ: integer | null Format: int64

liczba wyników zwróconych w tablicy items

targets
Typ: object | null

targets z tablicy POST

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

łączna liczba wyników pasujących do żądania

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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
      ]
    ]
  }
]'

Pokaż schemat

{
  "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]"
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Przecięcie stron

UwierzytelnianieRequired

DataForSEO

Przecięcie stron

Informacje o cenach