Bing Image Data Feed

noteNote
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.

noteNote
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.

noteNote
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

Element name
Attributes:
* Required attributes
Description Example
hostPageUrl [KEY] The page that shows the image.
"hostPageUrl": "http://www.foo.com/seattle/SpaceNeedle.html"
contentUrl [KEY] The URL to the actual full-size image file. Also the main image shown if it belongs to a photo album.
"contentUrl": "http://www.foo.com/images/12345.jpg"
name Display title of the image.
"name": "Space Needle"
author
Attributes:
  • alternateName*
  • name
  • url*
The image uploader's name and username. Username represented by alternateName. Author's real name is optional.
"author": { 
  "alternateName": "Seattle Man",
  "url": "http://foo.com/users/SeattleMan"
}
description The description/caption of the image.
"description": "A Day at the Space Needle"
encodingFormat Type of images supported: jpeg, gif, bmp, png, svg.
"encodingFormat": "jpeg"
height Height of image
"height": 280
width Width of image
"width": 340
contentSize File size in bytes
"contentSize": "156789"
thumbnail
Attributes:
  • url*
  • height
  • width
Small image representation of the main or full-size image
"thumbnail": { 
  "url": "http://www.foo.com/thumbs/thumb_12345.jpg",
  "height": 80, 
  "width":100 
}
bing:isFamilyFriendly Specifies whether the image content is family friendly. Values initially include:
  • porn
  • violence
  • gambling
  • drugs
  • alcohol
  • If not provided, then assumed family friendly.
    "bing:isFamilyFriendly": "porn"
    keywords A list of keywords or tags used to describe the image, delimited by commas.
    "keywords": [ 
      "Space",
      "Needle",
      "Seattle"
    ]
    
    datePublished Date the image was first added or published on the website in ISO 8601 format with UTC.
    "datePublished": "2015-02-23T05:10:11Z"
    dateModified Date when image or any image-related metadata was modified in ISO 8601 format with UTC.
    "dateModified": "2015-04-29T15:16:55Z"
    aggregateRating
    Attributes:
    • ratingCount*
    • ratingValue*
    • bestRating
    • worstRating
    Ratings about an image.
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": 4,
      "reviewCount": 3077,
      "bestRating": 5,
      "worstRating": 1
    }
    
    interactionCount
    Attributes:
    • UserViews (Bing extended)
    • UserComments
    • UserLikes
    • UserDownloads
    • UserShares (Bing extended, encompasses tweets, FB shares, etc)
    User interactions with an image in the form of view count, comment count, favorites count, download count and shares count. All attributes are optional.
    "interactionCount": [
      "UserViews:19403",
      "UserComments:78",
      "UserLikes:5695",
      "UserDownloads:195",
      "UserShares:1203"
    ]
     
    license Link to specify the machine readable license associated with the content.
    "license": {
      "@type": "URL",
      "url": "http://creativecommons.org/licenses/by/3.0/us/"
    }
    
    copyrightHolder Party holding legal copyright.
    "copyrightHolder": { 
      "@type": "Organization",
      "name": "Foo Bar Media"
    }
    
    copyrightYear Year during which the claimed copyright was first asserted.
    "copyrightYear": "2007"
    CollectionPage A collection that this image belongs to. There can be multiple collections an image is a part of due to user's re-using an image.

    Notes: collections maps to photo "set" in Flickr, blog in Tumblr, board in Pinterest, etc.

    "CollectionPage": [ 
      { 
    "@type": "CollectionPage",
    "url": "http://www.foo.com/Author/albums/spaceneedle"
      },
      {
    "@type": "CollectionPage",
    "url": "http://www.foo.com/Author/albums/seattleman2009"
      }
    ]
    
    geo
    Attributes:
    • lat*
    • long*
    • name
    Specify geographical information about locations captured of image. Name value is optional, lat/long are required.
    Coordinates are "+" for North or East and "-" for South or West.
    "contentLocation": {
      "@type": "Place",
      "geo": {
        "@type": "GeoCoordinates",
        "latitude": "47.6204",
        "longitude": "="-122.3491"
      },
      "name": "Space Needle"
    }
    
    exifData
    Attributes:
    • make
    • model
    • lens
    • film
    • ISO
    • aperture
    • shutterSpeed
    • focalLength
    • date (when photo was taken): format is different because abiding by EXIF format
    Camera information related to a photo directly extracted from EXIF header. Schema.org does not specify properties so below properties are defined by Bing.
    "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

    Element name
    Attributes:
    * Required attributes
    Description Example
    url [KEY] User-facing page url that contains product info. May be same as original page.
    "url": "http://www.foo.com/seattle/products/SpaceNeedle.html"
    image [KEY]
    Attributes:
    • representativeOfPage
    Image(s) [1 to many] showing the product, typically representative of url. May be same as original image. Use additional attribute to indicate which image is primary. If multiple images, only the image labeled as representativeOfPage is considered as part of the key.
    "image": [
      {
    "@type": "ImageObject",
    "contentUrl": "http://www.foo.com/images/12345.jpg",
    "representativeOfPage": true
      },
      {
    "@type": "ImageObject",
    "contentUrl": "http://www.foo.com/images/02.jpg"
      }
    ]
    
    name Product title
    "name": "Space Needle 10 in. model"
    brand Brand of the product
    "brand": "Lego"
    logo Url of logo for the brand/product line
    "logo": "http://www.lego.com/logo.png"
    description Official product description
    "description": "Have a piece of the Seattle skyline wherever you travel"
    datePublished Date the product was published online and publicly visible
    "datePublished": "2015-02-23T05:10:11Z"
    price Cost of product for a consumer to purchase
    "price": 19.99
    priceCurrency Country's system of money in ISO 4217. USD, EUR, ...
    "priceCurrency": "USD"
    availability Item availability. Enum values as defined in schema.org:
    • Discontinued
    • InStock
    • InStoreOnly
    • LimitedAvailability
    • OnlineOnly
    • OutOfStock
    • PreOrder
    • SoldOut
    "availability": "InStock"
    aggregateRating
    Attributes:
    • ratingCount*
    • ratingValue*
    • bestRating
    • worstRating
    Ratings about a product.
    "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": 4,
        "reviewCount": 3077,
        "bestRating": 5,
        "worstRating": 1
      }
    
    bing:category Shopping categories the product falls under, comma-delimited.
    "category": "models, toys"
    keywords A list of keywords or tags used to describe the product, delimited by commas.
    "keywords": [ 
      "space needle", 
      "seattle", 
      "model", 
      "toy",
      "lego"
    ]
    

    Recipe

    Element name
    Attributes:
    * Required attributes
    Description Example
    url [KEY] User-facing page url that contains recipe info. May be same as original page.
    "url": "http://allrecipes.com/Recipe/Space-Needle-Smoothie/"
    image [KEY]
    Attributes:
    • representativeOfPage
    Image(s) [1 to many] showing the recipe, typically representative of url. May be same as original image. Use additional attribute to indicate which image is primary. If multiple images, only the image labeled as representativeOfPage is considered as part of the key.
    "image": [
      {
    "@type": "ImageObject",
    "contentUrl": "http://www.foo.com/images/01.jpg",
    "representativeOfPage": true
      },
      {
    "@type": "ImageObject",
    "contentUrl": "http://www.foo.com/images/02.jpg"
      }
    ]
    
    name Recipe title
    "name": "Space Needle Smoothie"
    author Author who created the recipe
    "author":{
      "alternateName":"MOOSIE88",
      "url":"http://allrecipes.com/cook/1698295/profile.aspx"
    },
    
    description High-level summary or description of the recipe
    "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."
    ingredients List of ingredients
    "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 Total time taken to complete the recipe P is the duration designator (historically called "period") placed at the start of the duration representation. T is the time designator that precedes the time components of the representation.
    "totalTime": "PT1H15M"
    cookTime Time estimated for cooking portion
    "cookTime": "PT1H"
    prepTime Length of time taken to prepare the recipe
    "prepTime": "PT15M"
    datePublished Date the recipe was published online and publicly visible
    "datePublished": "2011-03-02T12:23:57Z"
    aggregateRating
    Attributes:
    • ratingCount*
    • ratingValue*
    • bestRating
    • worstRating
    Ratings about a recipe.
    "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": 4,
        "reviewCount": 2,
        "bestRating": 5,
        "worstRating": 1
      }
    
    keywords A list of keywords or tags used to describe the recipe, delimited by commas.
    "keywords": [ 
      "space needle", 
      "smoothie", 
      "drink"
    ]
    
    recipeCategory Category of recipe (appetizer, entree, etc.)
    "recipeCategory": "drink"
    recipeCuisine Cuisine of recipe (French, Ethiopian, Chinese, etc.)
    "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"
       },
       ...
      ]   
    }