Google SEO Hints

An API-friendly alternative to the manual Rich Results Test service.

Automatically detect potential SEO issues within your structured data based on Google's documentation and best practices. For each identified issue, you'll find actionable recommendations and relevant documentation links to learn more about the underlying requirements.

As a complement to official tools like Rich Results Test and Search Console, we can provide automated and, typically, more detailed validation results before you even publish. Since there are quite a few discrepancies between their documentation and tools, our validation generally follows the stricter recommendations.

Usage

Enable SEO Hints based on the tools below. Keep in mind that other services, such as Schema.org, will continue to evaluate documents, too, so you may see data messages from multiple services.

Playground enable the Google SEO Hints option from the Settings dialog.
Command Line add the --service=google-seo-hints flag to supported commands.
Developer API send the service=google-seo-hints parameter to supported methods.

Anonymous access is subject to additional usage limits. Refer to the pricing page for more details.

Messages

Similar to the Rich Results Test, as we validate your structured data, we annotate items or their properties with the following kinds of messages.

Supported Classes

We maintain policies for the following classes, based closely on their corresponding documentation topics. Not all topics or classes may be applicable for a given resource.

DocumentationSupported Classes
ArticleArticle, BlogPosting, NewsArticle, Organization, Person
BreadcrumbBreadcrumbList, ListItem
CarouselItemList, ListItem, Thing
Course listCourse
DatasetDataDownload, Dataset
Discussion forumComment, DiscussionForumPosting, InteractionCounter, Organization, Person, SocialMediaPosting
Education Q&AAlignmentObject, Question, Quiz, Thing
Employer aggregate ratingEmployerAggregateRating, Organization
EventEvent, Offer, Organization, PerformingGroup, Person, Place
FAQAnswer, FAQPage, Question
Image metadataImageObject, Organization, Person
Job postingCountry, JobPosting, MonetaryAmount, Organization, Place, PostalAddress, PropertyValue, QuantitativeValue
Local businessGeoCoordinates, LocalBusiness, OpeningHoursSpecification, Organization, Restaurant, VacationRental
Loyalty programCreditCard, MemberProgram, MemberProgramTier, MonetaryAmount, UnitPriceSpecification
Math solverEntryPoint, LearningResource, MathSolver, PropertyValueSpecification, SolveMathAction
Merchant listing3DModel, Certification, Country, DefinedRegion, MediaObject, MerchantReturnPolicy, MonetaryAmount, Offer, OfferShippingDetails, PeopleAudience, Product, SizeSpecification, UnitPriceSpecification
Merchant return policyCountry, MerchantReturnPolicy, MerchantReturnPolicySeasonalOverride
Merchant shipping policyCountry, DefinedRegion, MonetaryAmount, OpeningHoursSpecification, QuantitativeValue, ServicePeriod, ShippingConditions, ShippingRateSettings, ShippingService
Movie carouselMovie
OrganizationContactPoint, Country, MerchantReturnPolicy, Organization, PostalAddress
Paywalled ContentArticle, Blog, Comment, Course, CreativeWork, HowTo, Message, NewsArticle, Review, WebPage, WebPageElement
Product snippetAggregateOffer, ItemList, ListItem, Offer, PriceSpecification, Product, Review
Profile pageInteractionCounter, Organization, Person, ProfilePage
Q&AAnswer, Comment, Organization, Person, QAPage, Question, VideoObject
RecipeHowToDirection, HowToSection, HowToStep, HowToTip, Recipe
Review snippetAggregateRating, Book, Course, CreativeWorkSeason, CreativeWorkSeries, Episode, Event, Game, HowTo, LocalBusiness, MediaObject, Movie, MusicPlaylist, MusicRecording, Organization, Person, Product, Rating, Recipe, Review, SoftwareApplication
Software appMobileApplication, Offer, SoftwareApplication, WebApplication
SpeakableArticle, WebPage
Vacation rentalAccommodation, BedDetails, Brand, Country, LocationFeatureSpecification, PostalAddress, QuantitativeValue, Review, VacationRental
VariantsProduct, ProductGroup
VideoBroadcastEvent, Clip, EntryPoint, InteractionCounter, PropertyValueSpecification, SeekToAction, VideoObject

Resources