v0.2.0-beta

OpenAPI 3.1.0

Strony domeny

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

Strony domeny

Strony jednego target, do których prowadzą linki przychodzące, wraz z widokiem crawlera: main_domain, domain, tld, page, ip, first_visited, prev_visited i fetch_time. Pozwala ustalić, które strony faktycznie zdobywają linki. Jeśli potrzebujesz liczników linków zwrotnych na stronę, a nie metadanych o indeksowaniu, użyj post_dataforseo_backlinks_domain_pages_summary_live.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.0276.
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_filters
  Typ: array (object | null)[] | null
  
  filtruj linki zwrotne Twojego target
  pole opcjonalne
  za pomocą tego pola możesz filtrować początkowe linki zwrotne, które zostaną uwzględnione w zbiorze danych do zagregowanych metryk dla Twojego target
  linki zwrotne możesz filtrować według wszystkich pól dostępnych w odpowiedzi tego endpointu
  za pomocą tego parametru możesz uwzględnić w odpowiedzi tylko linki zwrotne dofollow i utworzyć elastyczny zbiór linków zwrotnych do obliczania metryk
  przykład:
  "backlinks_filters": ["dofollow", "=", true]
  
  Pusty obiekt
- 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;
  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 wynikach
  wartość domyślna: true
- 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:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  Pełna lista możliwych filtrów jest dostępna tutaj.
  
  Pusty obiekt
- include_subdomains
  Typ: boolean | null
  
  wskazuje, czy subdomeny target 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:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  wartość domyślna: 10
  wartość maksymalna: 1000
- limit
  Typ: integer | null
  
  maksymalna liczba zwracanych stron
  pole opcjonalne
  wartość domyślna: 100
  wartość maksymalna: 1000
- offset
  Typ: integer | null
  
  przesunięcie w tablicy wyników zwracanych stron
  pole opcjonalne
  wartość domyślna: 0
  jeśli podasz wartość 10, pierwszych dziesięć stron w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych stron
- 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:
  ["page_summary.backlinks,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:
  ["page_summary.backlinks,desc","page_summary.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
- target
  Typ: string
  
  domena lub subdomena
  pole wymagane
  domenę lub subdomenę należy podać bez https:// i www.
  przykład:
  forbes.com

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo
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_BacklinksDomainPagesLiveTaskInfo
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

tablica pozycji

content_encoding
Typ: string | null

typ kodowania

domain
Typ: string | null

domena
domena, na której znaleziono stronę

encoded_size
Typ: integer | null

rozmiar strony po kodowaniu
wskazuje rozmiar zakodowanej strony w bajtach

fetch_time
Typ: string | null

najnowsza data i godzina wizyty naszego crawlera na stronie
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2017-01-24 13:20:59 +00:00

first_visited
Typ: string | null

data i godzina pierwszej wizyty na stronie
data i godzina, kiedy nasz crawler po raz pierwszy odwiedził tę stronę
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2017-01-24 13:20:59 +00:00

ip
Typ: string | null

adres protokołu internetowego

location
Typ: string | null

nagłówek Location
wskazuje adres URL, na który przekierowywana jest strona, jeśli istnieje

main_domain
Typ: string | null

główna domena witryny
główna domena witryny nie obejmuje subdomen

media_type
Typ: string | null

typy mediów używanych do wyświetlania strony

meta
Typ: object | null · Response36Afe1097B20_BacklinksPageMeta

metadane strony

canonical
Typ: string | null

strona kanoniczna

charset
Typ: string | null

kodowanie znaków
przykłady:
utf-8

external_links_count
Typ: integer | null Format: int64

liczba linków zewnętrznych na stronie

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

tag h1
zawartość tagów h1

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

tag h2
zawartość tagów h2

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

tag h3
zawartość tagów h3

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

zawartość tagów alt

images_count
Typ: integer | null Format: int64

liczba obrazów na stronie

internal_links_count
Typ: integer | null Format: int64

liczba linków wewnętrznych na stronie

language
Typ: string | null

język treści strony
przykład:
en

page_spam_score
Typ: integer | null

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

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

typ platformy

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

szczegóły CMS

social_media_tags
Typ: object | null
propertyName
Typ: string | null
technologies
Typ: object | null

technologie witryny

propertyName
Typ: string | null
title
Typ: string | null

tytuł strony

words_count
Typ: integer | null Format: int64

liczba słów na stronie

page
Typ: string | null

adres URL strony
odpowiedni adres URL strony

page_summary
Typ: object | null · Response36Afe1097B20_PageSummary

zawiera dane o linkach zwrotnych dla tej strony

backlinks
Typ: integer | null Format: int64

wskazuje liczbę linków zwrotnych

backlinks_spam_score
Typ: integer | null Format: int64

średnia ocena spamu linków zwrotnych wskazujących na stronę
więcej o sposobie obliczania tego miernika znajdziesz na tej stronie Centrum pomocy

broken_backlinks
Typ: integer | null Format: int64

liczba niedziałających linków zwrotnych
liczba niedziałających linków zwrotnych prowadzących do page

broken_pages
Typ: integer | null

liczba niedziałających stron
liczba stron, do których wskazują linki zwrotne i które odpowiadają kodami statusu 4xx lub 5xx

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

lost_date
Typ: string | null

data i godzina utraty ostatniego linku zwrotnego dla tej strony
wskazuje datę i godzinę, kiedy nasz crawler odwiedził stronę i otrzymał kod statusu 4xx lub 5xx, albo kiedy usunięto ostatni link zwrotny
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2017-01-24 13:20:59 +00:00

rank
Typ: integer | null

rank strony
rank page
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

referring_domains
Typ: integer | null Format: int64

wskazuje liczbę domen odsyłających

referring_domains_nofollow
Typ: integer | null Format: int64

liczba domen wskazujących co najmniej jeden link nofollow do page

referring_ips
Typ: integer | null Format: int64

liczba adresów IP odsyłających
liczba adresów IP wskazujących na tę stronę

referring_links_attributes
Typ: object | null
propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_countries
Typ: object | null
propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Typ: object | null
propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Typ: object | null
propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_tld
Typ: object | null
propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_types
Typ: object | null
propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_main_domains
Typ: integer | null Format: int64

wskazuje liczbę głównych domen odsyłających

referring_main_domains_nofollow
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_pages
Typ: integer | null Format: int64

wskazuje liczbę stron prowadzących do page

referring_pages_nofollow
Typ: integer | null Format: int64

liczba stron odsyłających, które wskazują co najmniej jeden link nofollow do page

referring_subnets
Typ: integer | null Format: int64

liczba podsieci odsyłających

prev_visited
Typ: string | null

data poprzedzająca najnowszą wizytę naszego crawlera na stronie
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2017-01-24 13:20:59 +00:00

server
Typ: string | null

wersja serwera

size
Typ: integer | null

wskazuje rozmiar strony w bajtach

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

tld
Typ: string | null

domena najwyższego poziomu
domena najwyższego poziomu w strefie korzeniowej DNS

type
Typ: string | null

typ elementu

items_count
Typ: integer | null Format: int64

liczba elementów w tablicy items

target
Typ: string | null

target w tablicy POST

total_count
Typ: integer | null Format: int64

łączna liczba odpowiednich elementów w bazie danych

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

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": [
        {
          "target": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Strony domeny

UwierzytelnianieRequired

DataForSEO

Strony domeny

Informacje o cenach