v0.2.0-beta

OpenAPI 3.1.0

Podsumowanie stron 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_summary/live

Podsumowanie stron domeny

Metryki linków zwrotnych dla poszczególnych stron jednego target: jeden wiersz na url z rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks i broken_pages. Stronowy odpowiednik post_dataforseo_backlinks_summary_live, który podaje te same metryki dla całej domeny. Jeśli zamiast tego potrzebujesz metadanych o indeksowaniu tych stron, użyj post_dataforseo_backlinks_domain_pages_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 backlinki Twojego target
  pole opcjonalne
  za pomocą tego pola możesz filtrować początkowe backlinki, które zostaną uwzględnione w zbiorze danych do zagregowanych metryk dla Twojego target
  backlinki 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 backlinki dofollow i utworzyć elastyczny zbiór backlinków do obliczania metryk
  przykład:
  "backlinks_filters": [["dofollow", "=", true]]
  
  Pusty obiekt
- backlinks_status_type
  Typ: string | null
  
  określa, które backlinki zwrócić i zliczyć
  pole opcjonalne
  za pomocą tego pola możesz wybrać, które backlinki zostaną zwrócone i wykorzystane do zagregowanych metryk dla Twojego target;
  możliwe wartości:
  all — zostaną zwrócone i zliczone wszystkie backlinki;
  live — zostaną zwrócone i zliczone backlinki znalezione podczas ostatniej kontroli;
  lost — zostaną zwrócone i zliczone utracone backlinki;
  
  wartość domyślna: live
- exclude_internal_backlinks
  Typ: boolean | null
  
  wskazuje, czy linki zwrotne z subdomen target są wykluczone
  pole opcjonalne
  jeśli ustawisz false, linki zwrotne z subdomen domeny target zostaną pominięte i nie otrzymasz tej samej domeny w odpowiedzi;
  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:
  ["referring_links_types.anchors",">","1"]
  
  [["broken_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  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 target 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 target 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 domeny 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 kotwic
  pole opcjonalne
  wartość domyślna: 100
  wartość maksymalna: 1000
- offset
  Typ: integer | null
  
  przesunięcie w tablicy wyników zwracanych kotwic
  pole opcjonalne
  wartość domyślna: 0
  jeśli podasz wartość 10, pierwsze dziesięć kotwic w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych kotwic
- 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:
  ["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:
  ["backlinks,desc","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, subdomena lub strona internetowa, dla której mają zostać pobrane dane podsumowania
  pole wymagane
  domenę lub subdomenę należy podać bez https:// i www.
  stronę należy podać jako pełny URL (z http:// lub https://)

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_BacklinksDomainPagesSummaryLiveResponseInfo
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_BacklinksDomainPagesSummaryLiveTaskInfo
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

backlinks
Typ: integer | null Format: int64

liczba 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 wskazujących na stronę

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 do tej strony
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 do tej strony
wskazuje datę i godzinę, kiedy nasz crawler odwiedził stronę i otrzymał w odpowiedzi 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 do strony

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

atrybuty linków odsyłających
wskazuje atrybuty linków odsyłających i liczbę linków dla każdego atrybutu

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_countries
Typ: object | null

kody krajów ISO linków odsyłających
wskazuje kody krajów ISO domen, w których znajdują się linki odsyłające, oraz liczbę linków dla każdego kraju

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Typ: object | null

typy platform odsyłających
wskazuje typy platform odsyłających i liczbę linków dla każdej platformy

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

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Typ: object | null

lokalizacje semantyczne linków odsyłających
wskazuje elementy semantyczne w HTML, w których znajdują się linki odsyłające, oraz liczbę linków dla każdej lokalizacji semantycznej

pełną listę elementów semantycznych znajdziesz tutaj
przykłady:
article, section, footer

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_tld
Typ: object | null

domeny najwyższego poziomu linków odsyłających
zawiera domeny najwyższego poziomu i liczbę linków odsyłających dla każdej z nich

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

referring_links_types
Typ: object | null

typy linków odsyłających
wskazuje typy linków odsyłających i liczbę linków dla każdego typu
możliwe wartości:
anchor, image, link, meta, canonical, alternate, redirect

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

liczba głównych domen wskazujących co najmniej jeden link nofollow do page

referring_pages
Typ: integer | null Format: int64

wskazuje liczbę stron wskazujących na odpowiedni url

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

type
Typ: string | null

typ elementu

url
Typ: string | null

adres URL strony

items_count
Typ: integer | null Format: int64

liczba pozycji w tablicy wyników

target
Typ: string | null

cel 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_summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 4,
    "order_by": [
      "backlinks,desc"
    ]
  }
]'

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,
              "url": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Podsumowanie stron domeny

UwierzytelnianieRequired

DataForSEO

Podsumowanie stron domeny

Informacje o cenach