Felo API PlatformFelo API Platform
Wszystkie endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Linki zwrotne

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

Linki zwrotne

​

Poszczególne linki przychodzące do jednego target, jeden wiersz na link. Zwraca total_count, items_count, items oraz search_after_token do stronicowania — używaj go zamiast offset po kilku pierwszych stronach. mode i custom_mode sterują grupowaniem, a backlinks_status_type wybiera linki aktywne, utracone lub wszystkie. Jeśli potrzebujesz liczby, a nie wierszy, użyj post_dataforseo_backlinks_summary_live; dla pogrupowanych domen odsyłających — post_dataforseo_backlinks_referring_domains_live.

Informacje o cenach

  • Rozliczanie: zgłoszony koszt odpowiedzi.
  • Referencyjny szacunek kosztu żądania: USD 0.06.
  • 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 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

    • custom_mode
      Typ: object | null

      typ grupowania szczegółowych wyników
      pole opcjonalne
      użyj tego obiektu, aby uzyskać określoną liczbę linków zwrotnych na field
      jeśli użyjesz custom_mode, mode zostanie zignorowany
      przykład:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        Typ: object | null
    • 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:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, 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:
      ["rank",">","80"]

      [["page_from_rank",">","55"],
      "and",
      ["dofollow","=",true]]

      [["first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]

      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

    • limit
      Typ: integer | null

      maksymalna liczba zwracanych linków zwrotnych
      pole opcjonalne

      wartość domyślna: 100
      wartość maksymalna: 1000

    • mode
      Typ: string | null

      typ grupowania wyników
      pole opcjonalne
      możliwe typy grupowania:
      as_is — zwraca wszystkie linki zwrotne
      one_per_domain — zwraca jeden link zwrotny na domenę
      one_per_anchor — zwraca jeden link zwrotny na kotwicę

      wartość domyślna: as_is

    • 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;
      Uwaga: wartość maksymalna to 20,000, użyj search_after_token, jeśli chcesz pominąć więcej wyników

    • 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

    • search_after_token
      Typ: string | null

      token do kolejnych żądań
      pole opcjonalne
      jest zwracany w identycznym polu odpowiedzi na każde żądanie;
      użyj tego parametru, aby uniknąć przekroczeń czasu przy próbie pobrania ponad 20,000 wyników w jednym żądaniu;
      podając unikalną wartość search_after_token z tablicy odpowiedzi, otrzymasz kolejne wyniki początkowego zadania;
      wartości search_after_token są unikalne dla każdego kolejnego zadania;
      Uwaga: jeśli w żądaniu podano search_after_token, wszystkie pozostałe parametry muszą być identyczne jak w poprzednim żądaniu

    • 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 linki zwrotne
      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_BacklinksBacklinksLiveResponseInfo
    • 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_BacklinksBacklinksLiveTaskInfo
        • 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

          • custom_mode
            Typ: object | null

            tryb niestandardowy określony w tablicy POST

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

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

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

            • image_url
              Typ: string | null

              URL obrazu
              adres URL prowadzący do obrazu w zasobie źródłowym lub w pamięci DataForSEO (gdy oryginalne źródło jest niedostępne)

            • 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, 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, jaki dany link zwrotny przekazuje do target
              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

            • ranked_keywords_info
              Typ: object | null · Response36Afe1097B20_RankedKeywordsInfo
              • page_from_keywords_count_top_10
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_100
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_3
                Typ: integer | null Format: int64

                Signed 64-bit integers (long type).

            • 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

          • items_count
            Typ: integer | null Format: int64

            liczba wyników zwróconych w tablicy items

          • mode
            Typ: string | null

            tryb określony w tablicy POST

          • search_after_token
            Typ: string | null

            token do kolejnych żądań
            podając unikalny search_after_token przy tworzeniu nowego zadania, otrzymasz kolejne wyniki zadania początkowego;
            wartości search_after_token są unikalne dla każdego kolejnego zadania

          • target
            Typ: string | null

            domena docelowa w tablicy POST

          • 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
Request Example for post/v1/beta/dataforseo/backlinks/backlinks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

{
  "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,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Backlinks