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.