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

Przecięcie domen

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

Przecięcie domen

​

Domeny linkujące do kilku celów naraz. ⚠️ targets jest tu obiektem kluczowanym pozycją — {"1": "a.com", "2": "b.com"} — a nie tablicą, jaką przyjmują endpointy zbiorcze. exclude_targets usuwa witryny z porównania. Każdy wiersz zawiera domain_intersection oraz summary dla każdego celu. Służy do znajdowania tych, którzy linkują do konkurencji, ale nie do Ciebie. Odpowiednik na poziomie stron to post_dataforseo_backlinks_page_intersection_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_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 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 linki zwrotne z subdomen target są wykluczone
      pole opcjonalne
      jeśli ustawisz false, linki zwrotne z subdomen target zostaną pominięte i nie otrzymasz tej samej domeny w odpowiedzi;
      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ć domeny odsyłające, które linkują do targets, ale nie linkują do exclude_targets
      przykład:
      "exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"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.internal_links_count",">","1"]

      [["2.referring_pages",">","2"],
      "and",
      ["1.backlinks",">","10"]]

      [["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["2.target","like","%dataforseo.com%"],"or",["1.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 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 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

    • intersection_mode
      Typ: string | null

      wskazuje, czy przecinać linki zwrotne
      pole opcjonalne
      użyj tego pola, aby przeciąć lub scalić wyniki dla podanych domen
      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 wyników
      pole opcjonalne
      wartość domyślna: 100
      wartość maksymalna: 1000

    • offset
      Typ: integer | null

      przesunięcie w tablicy zwracanych wyników
      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:
      ["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

    • 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": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}

      • propertyName
        Typ: string | null
Odpowiedzi
  • 200
    Typ: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveResponseInfo
    • 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_BacklinksDomainIntersectionLiveTaskInfo
        • 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 domeny linkujące do wszystkich targets z tablicy POST

            • domain_intersection
              Typ: object | null

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

              • propertyName
                Typ: object | null · Response36Afe1097B20_BacklinksDomainIntersection
                • 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 target
                  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

                • broken_pages
                  Typ: integer | null

                  liczba niedziałających stron

                • first_seen
                  Typ: string | null

                  data i godzina, kiedy nasz crawler po raz pierwszy znalazł link zwrotny z tego target
                  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 z tego target
                  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:
                  2019-11-15 12:57:46 +00:00

                • rank
                  Typ: integer | null

                  rank przypisany do target z tablicy POST
                  wskazuje rank, jaki domena odsyłająca (target powyżej) przekazuje Twojemu celowi z tablicy POST;
                  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

                  liczba domen odsyłających

                • referring_domains_nofollow
                  Typ: integer | null Format: int64

                  liczba domen wskazujących co najmniej jeden link nofollow do odpowiedniego celu

                • referring_ips
                  Typ: integer | null Format: int64

                  liczba adresów IP odsyłających

                • 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

                    Integer numbers.

                • 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

                • 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

                    Integer numbers.

                • 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

                  • propertyName
                    Typ: integer | null

                    Integer numbers.

                • 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

                    Integer numbers.

                • 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

                    Integer numbers.

                • referring_main_domains
                  Typ: integer | null Format: int64

                  liczba 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 target

                • referring_pages
                  Typ: integer | null Format: int64

                  wskazuje liczbę stron wskazujących na target

                • referring_pages_nofollow
                  Typ: integer | null Format: int64

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

                • referring_subnets
                  Typ: integer | null Format: int64

                  liczba podsieci odsyłających

                • target
                  Typ: string | null

                  domena, która linkuje do odpowiedniego celu z tablicy POST

                • type
                  Typ: string | null

                  typ elementu

            • summary
              Typ: object | null · Response36Afe1097B20_IntersectionSummaryInfo

              zawiera podsumowanie przecięć domen

              • 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

            domeny docelowe, subdomeny lub strony internetowe w tablicy POST

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

            łączna liczba wyników pasujących do Twojego żą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/domain_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": true
  }
]'

{
  "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": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Domain Intersection