Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The SEO RDF vocabulary, described using W3C RDF Schema and the Web Ontology Language. The vocabulary builds on and refers to schema.org where appropriate.
SEO Vocabulary
2023-10-29T00:00:00Z
SEO Vocabulary
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Declares the natural language of a chunk of text
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Each webpage has a main entity of type Thing: Person, Location, LocalBusiness etc.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Points to an entity representing the linked content, useful for dereferencing in GraphQL
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Indicates the WebPage that is described by this schema markup block. Useful for linking structured data to content
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Links a schema:WebPage to one or more Chunks representing segmented parts of the page
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Defines the relationship between a LinkGroup and the individual links it contains, helping to structure internal and external linking within a webpage
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Connects a WebPage to one or more LinkGroups that organize its internal links (e.g., navigation menus, sidebar sections, related content blocks). Enables grouping of links by purpose or position on the page
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The hasQuery property represents the relationship between a WebPage and the PageGroup class, designed to help identify in which group type, A/B testing-wise the group belongs to.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Associates a webpage with a target persona, representing the intended audience based on characteristics such as interests, demographics, or behavior
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
This object attribute helps us with the querying process of queries equal to certain text
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The hasQuery property represents the relationship between a WebPage and the Query that leads users to that page. It indicates that the WebPage is relevant or has been optimized for the specified Query. This relationship is crucial for understanding SEO dynamics, as it reflects the connection between user search behavior and web content.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The usesSchema property describes the relationship between a WebPage and the Schema it employs. The Schema class represents structured data, such as JSON-LD, Microdata, or RDFa, that is embedded in the webpage to provide search engines and other tools with enhanced information about the content.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The hasURL property establishes a unique and reciprocal relationship between a WebPage and its corresponding URL. It asserts that each WebPage is identified by exactly one URL, and conversely, each URL uniquely identifies one WebPage. As both a functional and inverse functional property, hasURL ensures that this link is both unique and bidirectional, which is critical for accurately representing the identity and accessibility of web content
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The influencedByQuery property defines the relationship between AnchorText and the Query that may shape or determine the choice of that anchor text. It highlights how specific search queries can influence the wording and selection of anchor texts within a WebPage, reflecting SEO strategies aimed at optimizing link relevance and search engine visibility. This property is vital for understanding the interplay between user search behavior and content creation, particularly in the context of link building and on-page SEO
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Links a Chunk to the parent WebPage it belongs to, defining the document structure
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Defines the relationship between a LinkGroup and the WebPage it belongs to, helping structure internal linking and improve content organization
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Inverse property of seovoc:hasLink, linking a link back to its parent LinkGroup
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
isPersonaFor links a Persona to the WebPage or Query it is intended to represent or target. It captures the relationship where a persona informs the content or intent behind a page or search query
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Defines the relationship between a search query (seovoc:Query) and the webpage (seovoc:WebPage) for which it serves as the main or most relevant query
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The link property represents the relationship between a WebPage and the various Links contained within it. Each instance of the Link class corresponds to a hyperlink found on the WebPage, capturing both internal and external connections. This property is essential for modeling the structure of a webpage, understanding the flow of traffic between pages, and analyzing link-based SEO strategies, as it reflects the network of connections that can influence search engine rankings and user navigation.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Each webpage has an entity of type Thing: Person, Location, LocalBusiness etc.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A unique identifier for the LinkGroup, allowing differentiation between link clusters on a webpage
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A list of keywords associated with the specific link, aiding semantic classification
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The human-readable name of the LinkGroup, typically reflecting its function or placement on a webpage (e.g., 'Footer Links', 'Sidebar Menu', 'Main Navigation').
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The position of the link on the webpage or within a list). Uses Schema.org’s position
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A URL pointing to a thumbnail image for the link, useful for visually rich links
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Represents the age range of a persona, typically expressed as a string (e.g., '18-25'). This property helps categorize personas by their approximate age groups for tailored strategies or content.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The text of the anchor tied to the link itself
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The bounce rate, originally coming as a metric from Universal Google Analytics. Needs to be accordingly modeled for GA4
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The order of the chunk on the webpage, starting from 1 for the first chunk. Useful for reconstructing the document from its parts or presenting chunks in context
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The name of the set of chunks (e.g., "Introduction", "Body", "Summary"). Useful for organizing chunks into meaningful groups
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Describes the chunking strategy applied to split the document (e.g., "Semantic Segmentation", "Fixed-Length", "Sentence-based")
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The plain text content of the chunk, stripped of formatting, used for embeddings, analysis, or display in NLP applications
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The click depth of the page itself. Example: https://wordlift.io/blog/en/seo-automation/ is on level 4 if we count the parts between //
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The average number of clicks the pages have for a given time period.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The total number of clicks the query has for a given time period of 28 Days
clicks28Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The trend of the clicks when we compare 28Days to 3Months period.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
clicks3Months
The total number of clicks the query has for a given time period of 3 months
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The total number of clicks the query has for a given time period of 7 days
clicks7Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The trend of the clicks when we compare 7Days to 28Days period
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The trend of the clicks when we compare 7Days to 3Months period
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The average click through rate (CTR) of the query for a given time period
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The click through rate for 28 days period
ctr28Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The click through rate trend for 28Days to 3Months period
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The click through rate for 3 months period
ctr3Months
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
ctr7Days
The click through rate for 7Days period
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The click through rate trend of 7days to 28days period
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The click through rate trend of 7Days to 3Months period
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The date/time this keyword analytics data has been extracted and imported in the KG.
dateCreated
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The actual vector value for the embedding itself.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The name of the NLP embedding model used to create vectorized version of the content.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The text used to create an embedding of the webpage itself.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The end offset of the chunk in the text, expressed as character or token position
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Indicates the name of the group in which the page belongs, A , B, C (control A, control B, test A, test ...B)
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Indicates the group type in which the page belongs, e.g. control or test.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A hash of the data to understand whether it changed
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
An ID when available
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A string representing the source of data or the procedure
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Impressions of the webpage as a metric coming from Google Search Console
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The impressions for a 28 months period
impressions28Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The impressions trend when you compare 28Days to 3Months
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The impressions of the webpage for a 3 months time period
impressions3Months
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The impressions for 7Days of the Webpage
impressions7Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The impressions trend of 7Days to 28Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The impressions trend of 7Days to 3Months
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Intent is done on a page level, so it will be added as a data property to the Page class
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Whether the page can be crawled according to robots.txt
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Primary and secondary keyword modeling are expressed through the use of the data property keywordType
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The label is the name of the entity, because Thing can be any entity, so we need to specify
Inbound
Outbound
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The type of the link, with two possible values inbound and outbound (internal link coming from the same website or external link coming from an external website)
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
This property represents a Markdown-formatted version of a webpage’s content, specifically structured for Large Language Model (LLM) processing. It ensures that textual content is clean, structured, and semantically rich, enhancing readability, comprehension, and knowledge extraction.Iit eliminates unnecessary HTML/CSS/JS clutter, improving efficient tokenization and retrieval-augmented generation (RAG) in AI applications.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
As a replacement for hasMenu
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The meta description of the webpage
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The meta title of the webpage
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A metric to define whether the nofollow is in place (True for Yes and False for No)
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The average ranking positon that the page has for a given time period on SERPs
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The ranking position for 28 Days on SERPs
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The ranking position trend for a given Query for 28Days to 3Months on SERPs
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The ranking position of the given Query for a 3 months time period on SERPs
position3Months
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The ranking positon of the given query for a 7Days time period on SERPs
position7Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The ranking position trend of 7Days to 28Days on SERPs
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The ranking position trend of 7Days to 3Months on SERPs
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Represents the device type a persona most commonly uses to access information or services. Examples include 'mobile', 'desktop', 'tablet', or 'smart speaker'. This property helps in tailoring content and strategies to the persona's preferred platform
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The date where the webpage was published
Advice
Explanations
Facts
Planning
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Represents the broader category of a user's information-seeking query. This property classifies queries into four key categories based on their intent and expected outcome:
- Advice: Queries that seek recommendations, suggestions, or guidance for decision-making.
- Explanations: Queries aimed at understanding concepts, reasoning, or detailed clarifications.
- Facts: Queries that request verifiable and objective pieces of information.
- Planning: Queries focused on structuring activities, workflows, or determining sequential steps to achieve a goal.
These categories help in organizing user search behaviors and improving query understanding.
Analytical
Causal
Commonsense
Cultural
Dynamic
Exploratory
Instructive
Lifestyle
Long-tail
Multi-hop
Philosophical
Popular
Recommendation
Spatio-temporal
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Specifies the type of query a user is performing, which must belong to a predefined set of query categories. These categories include: Popular, Long-tail, Dynamic, Multi-hop, Analytical, Commonsense, Causal, Exploratory, Instructive, Recommendation, Spatio-temporal, Lifestyle, Cultural, and Philosophical.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A specific function, position, or responsibility associated with a persona within a given context. This class defines how a persona interacts with a system, organization, or content, influencing their goals and actions.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The schema value itself of the publicly available schema on the webpage
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The overall score for the query for 28Days time period
score28Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The overall score for the query for 3Months time period
score3Months
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A calculated score ranging from 0.0 to 1.0 to determine the keywords with potential.
score7Days
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The raw HTML of the webpage itself.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The start offset of the chunk in the text, expressed as character or token position
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The HTTP status (response code) of the Webpage itself
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The actual title of the webpage itself
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The number of tokens in the chunk, typically counted using a tokenizer compatible with the embedding model or LLM processing the content
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The URL value of the Webpage itself
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The weight of the link, useful for ranking or tag clouds
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The Language class from Schema.org
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The Thing class from Schema.org
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
The WebPage class from Schema.org
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A Thing that may have a schema:url, hence may have analytics data bound to it.
Thing
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A class representing the anchor text of a hyperlink, which is the clickable text displayed for a link on a webpage. This class captures the textual content used to describe the target of the link, often influencing search engine optimization (SEO) and user experience. The AnchorText class is important for understanding how links are represented in the context of a webpage and how they contribute to the navigation and relevance of the content
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
Defines a Chunk, a self-contained section of a schema:WebPage used for vector search and structured representation
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A class representing a hyperlink found on a webpage. This class captures the attributes of a link and its type, such as whether the link is internal (pointing to the same domain) or external (pointing to a different domain). The Link class is crucial for understanding the structure and navigation of a website, as well as for analyzing the relationships between different web resources in the context of SEO and web development.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A collection of related links within a webpage, typically grouped by placement or function, such as navigation menus, footers, or sidebars. It helps structure internal linking and improves discoverability.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A class representing in which A/B testing group does the page belong: control A, control B, test A, test B and so on.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A representation of a specific audience or user group defined by key characteristics, including their role, brand association, age range, gender, location, problems they aim to solve, and preferred devices. This class is used to tailor content or strategies to meet the needs and expectations of these target personas.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A class representing a search query. Instances of this class encapsulate the parameters, conditions, and terms submitted to a search engine by users or systems. This class is fundamental to modeling and analyzing search behavior, including keyword selection, query intent, and search patterns in the context of SEO.
Query
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
This class represents schema markup, a form of structured data that defines the semantic relationships between entities on a webpage. Schema markup is used to enhance the understanding of web content by search engines and other applications, facilitating better indexing, richer search results, and improved interoperability across different systems. This class provides a framework for describing the types, properties, and relationships that constitute schema markup, enabling consistent and meaningful representation of web content.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
This class represents a unique URL that identifies a specific webpage. It is intended to serve as a stable and unambiguous reference to web content, ensuring consistent access to the webpage across various systems and applications. The URL should be a valid and well-formed HTTP or HTTPS address, uniquely pointing to a resource on the World Wide Web. NOT equivalent to schema.org's URL.
Andrea Volpini, David Riccitelli, Emilija Gjorgjevska, Milos Jovanovik
A web page. Every web page is implicitly assumed to be declared to be of type WebPage, so the various properties about that webpage, such as breadcrumb may be used. We recommend explicit declaration if these properties are specified, but if they are found outside of an itemscope, they will be assumed to be about the page.
WebPage