Klassifizierungen von Seitentyp und Kategorie
Site Explorer sagt den Typ und die Themenkategorie verweisender Seiten voraus. Die Endpunkte Alle Backlinks und Defekte Backlinks stellen diese Klassifizierungen über page_type_source und page_category_source bereit.
Beide Felder sind Zeichenketten, die null sein können. Eine Seite kann Klassifizierungen aus mehr als einer Top-Level-Gruppe haben, daher kann jedes Feld eine kommagetrennte Liste von Pfaden enthalten:
/Article/Tutorial_or_Guide,/Video/How_to
Behandle die Taxonomien als offene Wertemengen. Ahrefs kann Werte hinzufügen, wenn sich die Klassifizierungsmodelle ändern.
Seitentypen
Die Seitentyp-Taxonomie ist Ahrefs-spezifisch. Jeder Stammpfad ist auch für sich genommen ein gültiger Wert.
| Stammpfad | Verschachtelte Pfade |
|---|---|
/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 |
/Image | /Image/Infographic<br />/Image/Mapographic<br />/Image/Photography<br />/Image/Vector_Illustration<br />/Image/Meme<br />/Image/Diagram<br />/Image/Flowchart |
/Video | /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 |
Seitenkategorien
Seitenkategorien verwenden die Taxonomie der Inhaltskategorien von Google Cloud Natural Language, einschließlich aller dort aufgeführten Ebenen.
Ahrefs stellt jede Kategorie als Pfad mit vorangestelltem Schrägstrich dar. Leerzeichen werden zu Unterstrichen und & wird als and geschrieben. Zum Beispiel Googles Kategorie:
/Business & Industrial/Advertising & Marketing/Marketing
erscheint in der API als:
/Business_and_Industrial/Advertising_and_Marketing/Marketing
Kopiere nach Möglichkeit die exakten API-Pfade. Gehe nicht davon aus, dass das Ersetzen von Leerzeichen und kaufmännischen Und-Zeichen alle Satzzeichen in der Taxonomie abdeckt.
Warum nur die am stärksten verschachtelten Pfade zurückgegeben werden
Der Klassifikator kann ein übergeordnetes Element und ein spezifischeres untergeordnetes Element aus derselben Top-Level-Gruppe zuweisen. Die API entfernt die weniger spezifischen Pfade aus dem ausgewählten Wert.
Zum Beispiel wird diese Klassifizierung:
/Article
/Article/Tutorial_or_Guide
/Video
/Video/Interview
wie folgt zurückgegeben:
/Article/Tutorial_or_Guide,/Video/Interview
Die API gruppiert Pfade nach ihrer ersten Komponente, z. B. /Article oder /Video, und behält in jeder Gruppe die Pfade mit der größten Tiefe bei. Wenn zwei Pfade in einer Gruppe die gleiche größte Tiefe haben, werden beide zurückgegeben.
Diese Regel entfernt redundante Vorgänger aus der Antwort. Sie verhindert nicht, dass du nach einem übergeordneten Pfad filterst.
Nach einem übergeordneten Element und seinen untergeordneten Elementen filtern
Verwende substring mit dem vollständigen übergeordneten Pfad, der in literale doppelte Anführungszeichen eingeschlossen ist. Dieser Filter trifft auf /Article und seine untergeordneten Elemente zu:
{
"field": "page_type_source",
"is": ["substring", "\"/Article\""]
}
Die Anführungszeichen sind Teil des Substrings. Sie entsprechen dem exakten übergeordneten Schlüssel in den zugrunde liegenden Klassifizierungsdaten. Ohne sie würde /Article auch auf nicht zugehörige Pfade wie /Listing_Collection/Article zutreffen.
Verwende dieselbe Form für ein übergeordnetes Kategorieelement:
{
"field": "page_category_source",
"is": ["substring", "\"/Business_and_Industrial\""]
}
Verwende hierfür nicht prefix. Der Filter wird auf die zugrunde liegenden serialisierten Klassifizierungsdaten angewendet, nicht auf jeden Pfad im ausgewählten, kommagetrennten Wert.
Hier ist eine vollständige Anfrage für Artikel-Backlinks:
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'
Siehe Filtersyntax für zusammengesetzte Filter und die vollständige Operator-Referenz.