Bing Image Data Feed

NOTE
Bing supports other schemas as well for webmasters and site owners to share data to Bing — Google Product Feed, Google Image Sitemap, Yahoo MediaRSS, and Pinterest Rich Pins. Best results when using the Bing preferred schema described in this article.

This article will guide you to create an optimized image data feed for inclusion in the Bing Image index. The schema is based off of schema.org and slightly extended using Bing’s internal data modeling. Our goal is to leverage the standard vocabulary of schema.org as much as possible. We will also share required elements, optional elements, and properties inside each image document using JSON via a table. Examples are also included.

Once you have created the data feed and exposed an endpoint for Bing to pull from, please Bing Multimedia Feeds to get started.

NOTE
For partners who wish to push image-related data to Bing in a firehose feed, please contact us to discuss more details.

Bing Image Data Feed Format

Please use a parent object in the feed to describe the type & version of schema. If your feed is not real-time, please use the parent object to also include the following elements.

• _type: feed type (e.g. “images”, “collections”, “users”)
• name: your organization’s name to help identify source of the images
• url: your organization’s root url
• language: language
• datePublished: date the feed file was published to help with tracking
• itemCount: number of items in the feed (for batch only)

For the actual image items, please use a container to encapsulate all the images.

• images: container for the image metadata as individual documents

Please note that the feed should not contain the raw HTML or binary content. Bing will fetch HTML and image content based on the urls provided within the schema as appropriate.

Operations

Each item within the data feed is represented via individual containers. We will support CRUD operations within the feed (create, update, and delete). Primary keys must be included in each item sent to us.

Creates

• Object must contain primary keys (hostPageUrl and contentUrl for image)
• Metadata can be added to an image in a later update event

Updates

• Object must contain primary keys (hostPageUrl and contentUrl for image)
• Bing will attempt to maintain state of your item and support single-field updates. If seen before, element will be replaced. If not seen before, element will be added to existing image item.
• Support for single-field deletes using null value associated with appropriate key. Example: “description”: null.

Deletes

• Object must contain primary keys (hostPageUrl and contentUrl for image)
• Use the (optional) delete flag for whole item deletion. Example: “delete”: true

Images may take up to 2 weeks to get deleted from index.

NOTE
For urgent removals within 48 hours, we ask partners to send an email only if the content must also disappear on your publicly crawlable pages. Examples of valid urgent requests include: copyright owner has asked you to remove their content or customer has requested takedown from your site.

Schema

The image data feed schema is based off of the following objects within schema.org.

• https://schema.org/ImageObject
• https://schema.org/Product
• https://schema.org/Offer
• https://schema.org/Recipe

More segments amay be added in the future as Bing supports them. 3 different schemas are accepted to accommodate these segments. For sites that combine rich knowledge and image content (such as Pinterest rich pins), please create a parent ImageObject and use child product or recipe objects to represent the additional data.

1. Image: image hosting sites (Tumblr, Flickr, etc.)
2. Product: e-commerce sites (Amazon, etc.)
3. Recipe: instructional cooking sites (Allrecipes, etc.)

When an element contains a bing: prefix, we have extended beyond schema.org to add more detail.

ImageObject

"hostPageUrl": "http://www.foo.com/seattle/SpaceNeedle.html"

"contentUrl": "http://www.foo.com/images/12345.jpg"

"name": "Space Needle"

"author": { 
  "alternateName": "Seattle Man",
  "url": "http://foo.com/users/SeattleMan"
}

"description": "A Day at the Space Needle"

"encodingFormat": "jpeg"

"height": 280

"width": 340

"contentSize": "156789"

"thumbnail": { 
  "url": "http://www.foo.com/thumbs/thumb_12345.jpg",
  "height": 80, 
  "width":100 
}

"bing:isFamilyFriendly": "porn"

"keywords": [ 
  "Space",
  "Needle",
  "Seattle"
]

"datePublished": "2015-02-23T05:10:11Z"

"dateModified": "2015-04-29T15:16:55Z"

"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": 4,
  "reviewCount": 3077,
  "bestRating": 5,
  "worstRating": 1
}

"interactionCount": [
  "UserViews:19403",
  "UserComments:78",
  "UserLikes:5695",
  "UserDownloads:195",
  "UserShares:1203"
]

"license": {
  "@type": "URL",
  "url": "http://creativecommons.org/licenses/by/3.0/us/"
}

"copyrightHolder": { 
  "@type": "Organization",
  "name": "Foo Bar Media"
}

"copyrightYear": "2007"

"CollectionPage": [ 
  { 
"@type": "CollectionPage",
"url": "http://www.foo.com/Author/albums/spaceneedle"
  },
  {
"@type": "CollectionPage",
"url": "http://www.foo.com/Author/albums/seattleman2009"
  }
]

"contentLocation": {
  "@type": "Place",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "47.6204",
    "longitude": "="-122.3491"
  },
  "name": "Space Needle"
}

"exifData": {
  "make": "Nikon",
  "model": "D700 SLR",
  "lens": "AF NIKKOR35mm f/2D",
  "film": "35mm",
  "ISO": "200",
  "aperture": "f/2",
  "shutterSpeed": "160",
  "focalLength": "5.4mm",
  "date": " 2001:06:09 15:17:32"
}

Product

"url": "http://www.foo.com/seattle/products/SpaceNeedle.html"

"image": [
  {
"@type": "ImageObject",
"contentUrl": "http://www.foo.com/images/12345.jpg",
"representativeOfPage": true
  },
  {
"@type": "ImageObject",
"contentUrl": "http://www.foo.com/images/02.jpg"
  }
]

"name": "Space Needle 10 in. model"

"brand": "Lego"

"logo": "http://www.lego.com/logo.png"

"description": "Have a piece of the Seattle skyline wherever you travel"

"datePublished": "2015-02-23T05:10:11Z"

"price": 19.99

"priceCurrency": "USD"

"availability": "InStock"

"aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4,
    "reviewCount": 3077,
    "bestRating": 5,
    "worstRating": 1
  }

"category": "models, toys"

"keywords": [ 
  "space needle", 
  "seattle", 
  "model", 
  "toy",
  "lego"
]

Recipe

"url": "http://allrecipes.com/Recipe/Space-Needle-Smoothie/"

"image": [
  {
"@type": "ImageObject",
"contentUrl": "http://www.foo.com/images/01.jpg",
"representativeOfPage": true
  },
  {
"@type": "ImageObject",
"contentUrl": "http://www.foo.com/images/02.jpg"
  }
]

"name": "Space Needle Smoothie"

"author":{
  "alternateName":"MOOSIE88",
  "url":"http://allrecipes.com/cook/1698295/profile.aspx"
},

"description": "Thos sweet and delicious frozen mixed drink features hints of chocolate,
	coconut, almonds, and cherries. This recipe is a best-guess for a beverage friends encountered while visiting Seattle."

"recipeIngredient": [
  "ice",
  "2 fluid ounces amaretto (almond-flavored liqueur)",
  "2 fluid ounces white creme de cacao",
  "1 fluid ounce coconut cream",
  "3 fluid ounces whipping cream",
  "6 maraschino cherries  (optional)"
]

"totalTime": "PT1H15M"

"cookTime": "PT1H"

"prepTime": "PT15M"

"datePublished": "2011-03-02T12:23:57Z"

"aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4,
    "reviewCount": 2,
    "bestRating": 5,
    "worstRating": 1
  }

"keywords": [ 
  "space needle", 
  "smoothie", 
  "drink"
]

"recipeCategory": "drink"

"recipeCuisine": "American"

Feed Examples

Here are examples of the 3 different type of image objects for the Bing Image data feed. You can use these as reference when building the data feed for your content.

Example image feed

{
   "_type":"images",
   "name":"Foo Company",
   "url":"http://www.foo.com",
   "language":"English",
   "datePublished":"2014-01-01",
   "itemCount":10000,
   "images": [
-- Object with all required elements --
{
   "@context":{
      "bing":"http://www.bing.com/images/api/imagefeed/v1.0/"
   },
   "@type":"https://schema.org/ImageObject",
   "hostPageUrl":"http://www.foo.com/seattle/SpaceNeedle.html",
   "contentUrl":"http://www.foo.com/images/12345.jpg",
   "height":280,
   "width":340,
   "datePublished":"2015-02-23T05:10:11Z",
},
-- Object with all required and optional elements --
{
   "@context":{
      "bing":"http://www.bing.com/images/api/imagefeed/v1.0/"
   },
   "@type":"https://schema.org/ImageObject",
   "hostPageUrl":"http://www.foo.com/seattle/SpaceNeedle.html",
   "contentUrl":"http://www.foo.com/images/12345.jpg",
   "name":"Space Needle",
   "author":{
      "alternateName":"Seattle Man",
      "url":"http://foo.com/users/SeattleMan"
   },
   "description":"A Day at the Space Needle",
   "encodingFormat":"jpeg",
   "height":280,
   "width":340,
   "contentSize":"156789",
   "thumbnail":{
      "url":"http://www.foo.com/thumbs/thumb_12345.jpg",
      "height":80,
      "width":100
   },
   "bing:isFamilyFriendly":"porn",
   "keywords":[
      "Space",
      "Needle",
      "Seattle"
   ],
   "bing:category":"funny",
   "datePublished":"2015-02-23T05:10:11Z",
   "dateModified":"2015-04-29T15:16:55Z",
   "aggregateRating":{
      "@type":"AggregateRating",
      "ratingValue":4,
      "reviewCount":3077,
      "bestRating":5,
      "worstRating":1
   },
   "interactionCount":[
      "UserViews:19403",
      "UserComments:78",
      "UserLikes:5695",
      "UserDownloads:195",
      "UserShares:1203"
   ],
   "license":{
      "@type":"URL",
      "url":"http://creativecommons.org/licenses/by/3.0/us/"
   },
   "copyrightHolder":{
      "@type":"Organization",
      "name":"Foo Bar Media"
   },
   "copyrightYear":"2007",
   "CollectionPage":[
      {
         "@type":"CollectionPage",
         "url":"http://www.foo.com/Author/albums/spaceneedle"
      },
      {
         "@type":"CollectionPage",
         "url":"http://www.foo.com/Author/albums/seattleman2009"
      }
   ],
   "contentLocation":{
      "@type":"Place",
      "geo":{
         "@type":"GeoCoordinates",
         "latitude":"47.6204",
         "longitude":"-122.3491"
      },
      "name":"Space Needle"
   },
   "exifData":{
      "make":"Nikon",
      "model":"D700 SLR",
      "lens":"AF NIKKOR35mm f/2D",
      "film":"35mm",
      "ISO":"200",
      "aperture":"f/2",
      "shutterSpeed":"160",
      "focalLength":"5.4mm",
      "date":" 2001:06:09 15:17:32"
   }
   },
   ...
  ]   
}

Example Image feed (product)

{
   "_type":"images",
   "name":"Foo Company",
   "url":"http://www.foo.com",
   "language":"English",
   "datePublished":"2014-01-01",
   "itemCount":10000,
   "images": [
-- Image object but using product schema --
{
   "@context":{
      "bing":"http://www.bing.com/images/api/imagefeed/v1.0/"
   },
   "@type":"https://schema.org/Product",
   "url":"http://www.foo.com/seattle/products/SpaceNeedle.html",
   "image":[
      {
         "@type":"ImageObject",
         "contentUrl":"http://www.foo.com/images/12345.jpg",
         "representativeOfPage":true
      },
      {
         "@type":"ImageObject",
         "contentUrl":"http://www.foo.com/images/02.jpg"
      }
   ],
   "name":"Space Needle 10 in. model",
   "brand":"Lego",
   "logo":"http://www.lego.com/logo.png",
   "description":"Have a piece of the Seattle skyline wherever you travel",
   "bing:isFamilyFriendly":"porn",
   "datePublished":"2015-02-23T05:10:11Z",
   "price":19.99,
   "priceCurrency":"USD",
   "availability":"InStock",
   "aggregateRating":{
      "@type":"AggregateRating",
      "ratingValue":4,
      "reviewCount":3077,
      "bestRating":5,
      "worstRating":1
   },
   "category":[
      "models",
      "toys"
   ],
   "keywords":[
      "space needle",
      "seattle",
      "model",
      "toy",
      "lego"
   ]
   },
   ...
  ]   
}

Example Image feed (recipe)

{
   "_type":"images",
   "name":"Foo Company",
   "url":"http://www.foo.com",
   "language":"English",
   "datePublished":"2014-01-01",
   "itemCount":10000,
   "images": [
-- Image object but using recipe schema --
{
   "@context":{
      "bing":"http://www.bing.com/images/api/imagefeed/v1.0/"
   },
   "@type":"https://schema.org/Recipe",
   "url":"http://allrecipes.com/Recipe/Space-Needle-Smoothie/",
   "image":[
      {
         "@type":"ImageObject",
         "contentUrl":"http://www.foo.com/images/01.jpg",
         "representativeOfPage":true
      },
      {
         "@type":"ImageObject",
         "contentUrl":"http://www.foo.com/images/02.jpg"
      }
   ],
   "name":"Space Needle Smoothie",
   "author":{
      "alternateName":"MOOSIE88",
      "url":"http://allrecipes.com/cook/1698295/profile.aspx"
   },
   "description":"Thos sweet and delicious frozen mixed drink features hints of chocolate, coconut, almonds, and cherries. 
     This recipe is a best-guess for a beverage friends encountered while visiting Seattle.",
   "recipeIngredient":[
      "ice",
      "2 fluid ounces amaretto (almond-flavored liqueur)",
      "2 fluid ounces white creme de cacao",
      "1 fluid ounce coconut cream",
      "3 fluid ounces whipping cream",
      "6 maraschino cherries  (optional)"
   ],
   "totalTime":"PT1H15M",
   "cookTime":"PT1H",
   "prepTime":"PT15M",
   "datePublished":"2011-03-02T12:23:57Z",
   "aggregateRating":{
      "@type":"AggregateRating",
      "ratingValue":4,
      "reviewCount":2,
      "bestRating":5,
      "worstRating":1
   },
   "keywords":[
      "space needle",
      "smoothie",
      "drink"
   ],
   "recipeCategory":"drink",
   "recipeCuisine":"American"
   },
   ...
  ]   
}