Docs
Szukaj w dokumentacji...⌘K

Klasyfikacje typu strony i kategorii

Site Explorer przewiduje typ i kategorię tematyczną stron odsyłających. Punkty końcowe Wszystkie linki zwrotne i Niedziałające linki zwrotne udostępniają te klasyfikacje za pośrednictwem page_type_source oraz page_category_source.

Oba pola są łańcuchami znaków dopuszczającymi wartość null. Strona może mieć klasyfikacje z więcej niż jednej grupy najwyższego poziomu, więc każde pole może zawierać listę ścieżek rozdzielonych przecinkami:

/Article/Tutorial_or_Guide,/Video/How_to

Traktuj taksonomie jako zbiory otwarte. Ahrefs może dodawać wartości wraz ze zmianą modeli klasyfikacji.

Typy stron

Taksonomia typów stron jest specyficzna dla Ahrefs. Każda ścieżka główna jest też poprawną wartością samą w sobie.

Ścieżka głównaŚcieżki zagnieżdżone
/Listing/Listing/Product<br />/Listing/Property<br />/Listing/Job<br />/Listing/Service<br />/Listing/Event<br />/Listing/Location<br />/Listing/Business
/Listing_Collection/Listing_Collection/Article<br />/Listing_Collection/Product<br />/Listing_Collection/Property<br />/Listing_Collection/Job<br />/Listing_Collection/Service<br />/Listing_Collection/Event<br />/Listing_Collection/Location<br />/Listing_Collection/Business
/Article/Article/How_to<br />/Article/Tutorial_or_Guide<br />/Article/Listicle<br />/Article/Comparisons<br />/Article/Roundup<br />/Article/Product_or_Brand_Review<br />/Article/Opinion_Piece<br />/Article/News_Update<br />/Article/Thought_Leadership<br />/Article/Story<br />/Article/Recipe<br />/Article/FAQ<br />/Article/Checklists<br />/Article/Study_or_Research_Findings<br />/Article/Definitions<br />/Article/Wiki
/Landing_Page/Landing_Page/Service_Page<br />/Landing_Page/Location_Page<br />/Landing_Page/Product_Page<br />/Landing_Page/Course_Sales_Page<br />/Landing_Page/Product_Feature_Page<br />/Landing_Page/Pricing_Page
/Interactive_Tools/Interactive_Tools/Calculator<br />/Interactive_Tools/SaaS_Software<br />/Interactive_Tools/Map<br />/Interactive_Tools/Quiz<br />/Interactive_Tools/Poll<br />/Interactive_Tools/Simulator<br />/Interactive_Tools/Generator<br />/Interactive_Tools/Configurator
/Obraz/Image/Infographic<br />/Image/Mapographic<br />/Image/Photography<br />/Image/Vector_Illustration<br />/Image/Meme<br />/Image/Diagram<br />/Image/Flowchart
/Wideo/Video/How_to<br />/Video/Tutorial_or_Guide<br />/Video/Listicle<br />/Video/Comparisons<br />/Video/Compilation<br />/Video/Roundup<br />/Video/Product_or_Brand_Review<br />/Video/Opinion_Piece<br />/Video/News_Update<br />/Video/Thought_Leadership<br />/Video/Story<br />/Video/Recipe<br />/Video/Interview<br />/Video/Webinar<br />/Video/Vlog
/Audio/Audio/Podcast<br />/Audio/Webinar<br />/Audio/Interview<br />/Audio/Sound_Byte<br />/Audio/Music<br />/Audio/Audiobook<br />/Audio/Commentary
/Dokument/Document/Case_Study<br />/Document/Ebook<br />/Document/White_Paper<br />/Document/Slide_Deck<br />/Document/Research_Paper<br />/Document/Template<br />/Document/Report<br />/Document/Manual<br />/Document/Worksheet
/User_Generated_Content/User_Generated_Content/Forum_Thread<br />/User_Generated_Content/Discussions<br />/User_Generated_Content/Social_Media_Post<br />/User_Generated_Content/Reviews<br />/User_Generated_Content/Testimonials<br />/User_Generated_Content/Comments<br />/User_Generated_Content/Q&A
/Core_Page/Core_Page/Homepage<br />/Core_Page/About_Page<br />/Core_Page/Contact_Page<br />/Core_Page/FAQ_Page<br />/Core_Page/Blog_Index<br />/Core_Page/Services_Page<br />/Core_Page/Portfolio_Page<br />/Core_Page/Careers_Page<br />/Core_Page/Privacy_Policy_Page<br />/Core_Page/T&C_Page

Kategorie stron

Kategorie stron korzystają z taksonomii kategorii treści Google Cloud Natural Language, uwzględniając wszystkie wymienione tam poziomy.

Ahrefs reprezentuje każdą kategorię jako ścieżkę poprzedzoną ukośnikiem. Spacje są zamieniane na podkreślenia, a znak & jest zapisywany jako and. Na przykład kategoria Google:

/Business & Industrial/Advertising & Marketing/Marketing

pojawia się w API jako:

/Business_and_Industrial/Advertising_and_Marketing/Marketing

Jeśli to możliwe, kopiuj dokładne ścieżki API. Nie zakładaj, że zastąpienie spacji i znaku ampersand obejmuje wszystkie znaki interpunkcyjne w taksonomii.

Dlaczego zwracane są tylko najbardziej zagnieżdżone ścieżki

Klasyfikator może przypisać ścieżkę nadrzędną i bardziej szczegółową ścieżkę podrzędną z tej samej grupy najwyższego poziomu. API usuwa mniej szczegółowe ścieżki z wybranej wartości.

Na przykład taka klasyfikacja:

/Article
/Article/Tutorial_or_Guide
/Video
/Video/Interview

jest zwracana jako:

/Article/Tutorial_or_Guide,/Video/Interview

API grupuje ścieżki według ich pierwszego komponentu, np. /Article lub /Video, i zachowuje ścieżki o największej głębokości w każdej grupie. Jeśli dwie ścieżki w grupie mają tę samą największą głębokość, zwraca obie.

Ta zasada usuwa z odpowiedzi zbędne elementy nadrzędne. Nie uniemożliwia to filtrowania według ścieżki nadrzędnej.

Filtruj według elementu nadrzędnego i jego elementów podrzędnych

Użyj substring z pełną ścieżką elementu nadrzędnego ujętą w dosłowne znaki podwójnego cudzysłowu. Ten filtr dopasowuje /Article i jego elementy podrzędne:

{
  "field": "page_type_source",
  "is": ["substring", "\"/Article\""]
}

Cudzysłowy są częścią podciągu. Dopasowują dokładny klucz nadrzędny w bazowych danych klasyfikacji. Bez nich /Article dopasowałoby także niepowiązane ścieżki, takie jak /Listing_Collection/Article.

Użyj tej samej postaci dla elementu nadrzędnego kategorii:

{
  "field": "page_category_source",
  "is": ["substring", "\"/Business_and_Industrial\""]
}

Nie używaj do tego prefix. Filtr działa na bazowych zserializowanych danych klasyfikacji, a nie na każdej ścieżce w wybranej wartości rozdzielanej przecinkami.

Oto kompletne żądanie dla linków zwrotnych z artykułów:

curl --get 'https://api.ahrefs.com/v3/site-explorer/all-backlinks' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --data-urlencode 'target=example.com' \
  --data-urlencode 'mode=subdomains' \
  --data-urlencode 'select=url_from,url_to,page_type_source' \
  --data-urlencode 'where={"field":"page_type_source","is":["substring","\"/Article\""]}' \
  --data-urlencode 'limit=100'

Zobacz Składnia filtrów, aby poznać filtry złożone i pełną listę operatorów.