ImageData
Image DataMedia SEOGoogleApi.ContentWarehouse.V1.Model.ImageData
SEO Analysis
AI GeneratedGoverns image and media search features. Affects visibility in image search and media carousels. This model (Image Data) contains SEO-relevant attributes including colorScore, clipartDetectorScore, colorScoreVersion. Key functionality includes: The thumbnail is guaranteed to be kept in the serving system until the expiration timestamp has passed, in microseconds.
Actionable Insights for SEOs
- Monitor for changes in rankings that may correlate with updates to this system
- Consider how your content strategy aligns with what this signal evaluates
- Optimize image alt text, file names, and compression for image search
- Implement image structured data for enhanced visibility
- Consider video content strategy for video carousel visibility
Attributes
98expirationTimestampstringnilFull type: String.tThe thumbnail is guaranteed to be kept in the serving system until the expiration timestamp has passed, in microseconds.
h2cnumber(nilcorpusSelectionInfoCorpusSelectionInfo →nilFull type: list(GoogleApi.ContentWarehouse.V1.Model.CorpusSelectionInfo.tCorpus scoring info for images indexed through Amarna.
isUnwantedContentboolean(nilField to indicate the image is unwanted for search index. The data is propagated from amarna to alexandria to be annotated in the cdoc. Refer to image/repository/proto/unwanted_content.proto for more info.
colorScorelist(number(nilColorness scores for the image. Each score represents the amount of a particular color in the image. At the current time, there are 12 colors, so there should always be 0 or 12 values in this array. The 12 colors are black, blue, brown, gray, green, orange, pink, purple, red, teal, white, yellow. The convention is that the scores are stored in alphabetical order, so the first score is black, and the last score is yellow.
isIndexedByImagesearchboolean(nilIf this image was not selected for indexing by imagesearch, these fields say so and explain why.
thumbHeightinteger(nillastCrawlTimeinteger(nilMost recent timestamp in seconds when this URL was crawled.
nearDupFeaturesVersioninteger(nilImage content derived data used for finding image near dups. NOTE: This hash is generated by V1 hash computation.
clipartDetectorScorenumber(nilImage content based classifier scores.
thumbnailImageDataThumbnail →nilFull type: list(GoogleApi.ContentWarehouse.V1.Model.ImageDataThumbnail.tcolorScoreVersioninteger(nilcontentFirstCrawlTimeinteger(nilEarliest known crawl time among all neardups of this image (go/imagecontentage).
lineartDetectorVersioninteger(nilembeddedMetadataImageExifImageEmbeddedMetadata →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageExifImageEmbeddedMetadata.tthe EXIF/IPTC metadata
widthinteger(nilimageContentQueryBoostImageContentQueryBoost →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageContentQueryBoost.tImage Content Scored per query boosts. Currently this is filled by the pamir algorithm and populates the pamir_section.
shoppingProductInformationImageRepositoryShoppingProductInformation →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageRepositoryShoppingProductInformation.tThe Shoppable Images product information to be annotated in the Cdoc. All fields will be populated except the product location bounding box.
heightinteger(nilHeight
imageLicenseInfoImageSearchImageLicenseInfo →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageSearchImageLicenseInfo.tIndicates license info of this image, which will tell image search users how to use this image legally.
extendedExifPhotosImageMetadata →nilFull type: GoogleApi.ContentWarehouse.V1.Model.PhotosImageMetadata.tThe EXIF generated by photos backend team's (more specifically FIFE's) thumbnailer library. This exif model is more comprehensive since a dedicated team is constantly improving it and adding new fields over time. This is currently populated by moonshine for selected corpora.
nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageRepositoryNimaOutput.tProductionized Nima VQ score.
imagerankinteger(nilimageQualityClickSignalsImageQualityNavboostImageQualityClickSignals →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageQualityNavboostImageQualityClickSignals.tClick signals for measuring image quality (e.g., usefulness, presentation, appealingness, and engagingness). Click signals are considered Search CPS Personal Data.
finalPornScorenumber(nilA [0..1] porn score based on some image-level features (like content score, referrer statistics, navboost queries, etc.). See class RiflePornScorer for more details.
coloredPixelsFracnumber(nilFraction of the image that contains pixels over a certain saturation threshold: can be used to determine if the image is grayscale or not.
whiteBackgroundScoreVersioninteger(nilImage is likely an object on a white background (value on [0,1]).
lineartDetectorScorenumber(nilclusterIdstringnilFull type: String.tSuperlabels generated cluster id. This field is going to be deprecated, please use superlabels_v2_cluster_id instead.
restrictStringsstringnilFull type: list(String.tA string representation of all the restricts associated with this image.
hateLogoDetectionImageUnderstandingIndexingAnnotationGroup →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageUnderstandingIndexingAnnotationGroup.tHate logo detections from the VSS logo_recognition module.
clickMagnetScorenumber(nilA score in (0, 1] to indicate how likely this image is considered as a click magnet based on clicks received from bad queries.
nearDupFeaturesSmallVersioninteger(nilThe following fields contain information about a smaller and less powerful version of the hash, needed for neardup retrieval. A compressed and an encoded version of the small hash are stored below. The smaller hash may have a few variants to increase recall. NOTE: This hash is generated by V2 hash computation. A compressed version of the small hash. Currently, a 4-byte fingerprint.
styleAestheticsScoreLensDiscoveryStyleAestheticsScoreSignals →nilFull type: GoogleApi.ContentWarehouse.V1.Model.LensDiscoveryStyleAestheticsScoreSignals.tAesthetics score of a style image.
smearedTopWebLandingPageDocidsstringnilFull type: list(String.tWeb docids that correspond to high ranked smeared landing pages for this image. Used for conditional retrieval of actionable landing pages for image search.
robotedAgentsstringnilFull type: String.tCSV list of user agents for which this image should be considered roboted. Note: All images are crawled using googlebot-images, this exists for clients that require additional restrictions beyond googlebot-images such as news.
sizeinteger(nilSize in bytes of original (non-thumbnail)
canonicalDocidstringnilFull type: String.tThis is the image docid used in image search. For ImageData protos coming from Alexandria/Freshdocs, this is a 'required' field that MUST be populated.
pornFlagDataPornFlagData →nilFull type: GoogleApi.ContentWarehouse.V1.Model.PornFlagData.tUsed by the segindexer for combined www+image indices.
personAttributesLensDiscoveryStylePersonAttributes →nilFull type: GoogleApi.ContentWarehouse.V1.Model.LensDiscoveryStylePersonAttributes.tContains person attributes from the LookNet-Person model and the Style AI Iconic Person Scorer for the most iconic person in a style image.
generatedImageLikelihoodSignalImageRepositoryGeneratedImageLikelihoodSignal →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageRepositoryGeneratedImageLikelihoodSignal.tThe signal about the likelihood of whether the image is generated by Google.
clipartDetectorVersioninteger(niltestingScoreinteger(nilThis field is for testing purposes, more information in go/media-dirt-2022.
ocrGoodocGoodocDocument →nilFull type: GoogleApi.ContentWarehouse.V1.Model.GoodocDocument.tPruned OCR Goodoc see vss_aksara_ocr_util.h for the fields copied.
smearedTopWebLandingPagesSmearedWebLandingPageEntry →nilFull type: list(GoogleApi.ContentWarehouse.V1.Model.SmearedWebLandingPageEntry.twhiteBackgroundScorenumber(nildocidstringnilFull type: String.tfingerprint(non-canonicalized absolute image url) This is not the image docid. Use canonical_docid instead. For ImageData protos coming from Alexandria/Freshdocs, this is a 'required' field that MUST be populated. But once again, this is very likely NOT something you need. Use canonical_docid instead.
orbitIntentsQualityOrbitOrbitImageIntents →nilFull type: GoogleApi.ContentWarehouse.V1.Model.QualityOrbitOrbitImageIntents.tOrbit intents. More details on go/orbit-in-image-indexing.
flagsinteger(nilUse image_perdoc.h to read/write 'flags'.
thumbWidthinteger(nilThumbnail width.
packedFullFaceInfoFaceIndexing →nilFull type: GoogleApi.ContentWarehouse.V1.Model.FaceIndexing.tEncodes face number and largest face frac into a small package for storage in mustang. This is calculated directly from FaceDetectionResult.
nilFull type: GoogleApi.ContentWarehouse.V1.Model.ContentAwareCropsIndexing.tThe content-aware cropping information.
ocrTextboxesOcrPhotoTextBox →nilFull type: list(GoogleApi.ContentWarehouse.V1.Model.OcrPhotoTextBox.tText lines detected by OCR engine.
h2inumber(nil'Hovers to Impressions' and 'Hovers to Clicks' ratios for an image. These are considered Search CPS Personal Data due to concerns that they may be used to reidentify or confirm the presence of specific singleton (unique) queries.
isMultiframeboolean(nilTrue if the original image contains multiple frames (e.g., for animated or stereoscopic images).
ocrTaserGoodocDocument →nilFull type: GoogleApi.ContentWarehouse.V1.Model.GoodocDocument.tOcr detected by ocr_taser module.
featuredImagePropImageMonetizationFeaturedImageProperties →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageMonetizationFeaturedImageProperties.tProperties used in featured imagesearch project. inspiration_score indicates how well an image is related to products, or how inspirational it is.
unavailableAfterSecsstringnilFull type: String.tTime in seconds since epoch after which this image should be considered unavailable.
imageRegionsImageRegionsImageRegions →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageRegionsImageRegions.tRegions detected within the image (go/images-region-search-edd). Regions contain bounding boxes circumscribing objects of interest in the image, along with object labels. Regions may overlap.
fileFormatstringnilFull type: String.tTrue file format (not extension).
nilFull type: GoogleApi.ContentWarehouse.V1.Model.CommerceDatastoreImageDeepTags.tVSS generated deep tags for shopping images.
adaboostImageFeaturePornVersioninteger(nilnoIndexReasonstringnilFull type: list(String.tpersonDetectionSignalsLensDiscoveryStylePersonDetectionSignals →nilFull type: GoogleApi.ContentWarehouse.V1.Model.LensDiscoveryStylePersonDetectionSignals.tContains person detection result.
flowOutputImageContentFlowProtoProd →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageContentFlowProtoProd.tThe output of various features generated by the Flow framework, most importantly data from Starburst (go/starburst). Do NOT interact with the internals of this proto since they may change over time. Instead, use the existing interfaces that consume FlowProtoProd's directly, e.g., image/mustang/content/image_content_distance.h For more info, please contact image-content-core@.
photoDetectorVersioninteger(nilnumberFacesinteger(nilNumber of faces detected in the image
nearDupFeaturesSmallstringnilFull type: list(String.tdeepImageEngagingnessImageRepositoryDeepImageEngagingnessOutput →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageRepositoryDeepImageEngagingnessOutput.tProductionized Deep Image Engagingness score.
isVisibleboolean(nilTrue if the image is inlined on the page (typicially via ) or false if the image is linked to (via an href).
urlstringnilFull type: String.tCanonicalized absolute image url.
licensedWebImagesOptInStatestringnilFull type: String.tIndicates the web-master opt-in state of this image, and will be used for Google products to decide usage rights like showing large previews.
rankInNeardupClusterinteger(nilRank in near-dup cluster (go/image-rank-in-neardup-cluster). The rank is 1-indexed: rank 1 is the best.
thumbSizeinteger(nilcodomainStrengthinteger(nilLike is_visible, this is a property of the (web-doc, img_url) pair not just the image. A high codomain_strength indicates high confidence based on collected stats that the image is hosted on a companion domain. If not enough stats are available for codomain strength, this field may be absent in ImageData, and hence the CompositeDoc. Do not place negative values here. Permitted values range between 0 and image_quality_codomain::kMaxCodomainStrength defined in //image/quality/codomain/codomain-stats-utils.h.
deepCropDeepCropIndexing →nilFull type: GoogleApi.ContentWarehouse.V1.Model.DeepCropIndexing.tDeepCrop based cropping information. See go/creatism/deepcrop for details.
nearDupFeaturesstringnilFull type: String.tphotoDetectorScorenumber(nilfirstCrawlTimeinteger(nilEarliest known timestamp about this image. Today, this is the timestamp when the content key was generated for this image. The time is in seconds.
adaboostImageFeaturePornnumber(nilWarning: adaboost_image_feature_porn* and imageFeaturePorn fields are DEPRECATED in favor of brain_porn_scores. Please do not use them. Contact safesearch@ for transition advice.
brainPornScoresImageSafesearchContentBrainPornAnnotation →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageSafesearchContentBrainPornAnnotation.tA [0..1] SafeSearch scores based on image pixels, using Google Brain: porn, csai, violence, medical, and spoof. For porn only, if available prefer final_porn_score as it should be more precise than brain_porn_scores.porn_score.
styleImageTypeLensDiscoveryStyleStyleImageTypeSignals →nilFull type: GoogleApi.ContentWarehouse.V1.Model.LensDiscoveryStyleStyleImageTypeSignals.tPrediction of a style image type: Stage, Stock, Street or Outfits.
animatedImageDataImageRepositoryAnimatedImagePerdocData →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageRepositoryAnimatedImagePerdocData.tPresent for animated images only: additional animatated image perdoc data.
onPageAlternateUrlstringnilFull type: String.tFor an image not explicitly visible on this page, the following url is the one which most closely matches it.
largestFaceFracnumber(nilFraction of image covered by the largest face (should match largestFaceFraction, but without scaling). In perdocs, is set only if numberFaces > 0.
imageExactBoostImageExactBoost →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageExactBoost.tA set of query fingerprints and confidence scores. There queries are supposed to be relevant to the image with high confidence.
brainPornScoresVersionstringnilFull type: String.tA string that indicates the version of SafeSearch classifier used to compute brain_porn_scores.
multibangKgEntitiesImageDataMultibangEntities →nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageDataMultibangEntities.tadaboostImageFeaturePornMinorVersioninteger(nillargestFaceFractioninteger(nilFraction of image covered by the largest face, scaled by 1000. Warning: Is DEPRECATED in favor of largest_face_frac. Do not use.
finalPornScoreVersionstringnilFull type: String.tA string that indicates the version of SafeSearch classifier used to compute final_porn_score.
superlabelsV2ClusterIdstringnilFull type: String.tSuperlabels V2 generated cluster id.
isIipInScopeboolean(nilIIP in scope signal (go/iip). Set to true if the image is annotated with any iip_in_scope entities (go/iukp-trust-v2).
firstTimeSeenOnDocSecinteger(nilThe first time this image URL was seen on the containing web page. Only set during web indexing.
nilFull type: GoogleApi.ContentWarehouse.V1.Model.ImageRepositoryNimaOutput.tProductionized Nima AVA score. Both this field and nima_vq were added on the top of nima_ava_score and nima_vq_score because the signals are already integrated with Batch Amarna in image/repository/schema/global_output_tags.h using NimaOutput.
precomputedRestrictsPrecomputedRestricts →nilFull type: GoogleApi.ContentWarehouse.V1.Model.PrecomputedRestricts.tRestricts computed before building a Mustang index.
linkinfoTypestringnilFull type: String.tBitmask of LinkInfo enum in google3/indexing/converter/outlinks/linkinfo.h.
indexedVerticalsImageDataVerticalIndexingInfoImage →nilFull type: list(GoogleApi.ContentWarehouse.V1.Model.ImageDataVerticalIndexingInfoImage.tVertical indexing information for the document and associated image outlinks.