The Woot API v2 is in beta and is subject to change without notice.

GET events

Updated on Fri, 2013-11-15 15:19

Returns a collection of events, optionally filtered by site or event type.

Resource URL

http://api.woot.com/2/events.json

Parameters

key
required
Your public API key. This can be obtained by visiting your applications page.
site
optional
multiple
Restricts events to the specified site.
Valid values for site are:
  • www.woot.com
  • home.woot.com
  • electronics.woot.com
  • computers.woot.com
  • tools.woot.com
  • sport.woot.com
  • accessories.woot.com
  • kids.woot.com
  • shirt.woot.com
  • wine.woot.com
  • sellout.woot.com
eventType
optional
multiple
Restricts events to the specified event type.
Valid values for eventType are (case-insensitive):
  • Daily
  • Ghost
  • Moofi
  • Reckoning
  • WootOff
  • WootPlus
select
optional
multiple
Restricts the returned properties to the specified values. The Id property will always be returned for all objects.

Example

Request

GET http://api.woot.com/2/events.json?site=www.woot.com&eventType=Daily&key={yourkey}

Response

[
  {
    "Type": "Daily",
    "Id": "ae74b3fd-c635-421d-ad83-18be98699ff9",
    "Title": "So Be It 2009 Pinot Noir (5)",
    "Site": "www.woot.com",
    "StartDate": "2012-07-06T05:00:00Z",
    "EndDate": "2012-07-07T05:00:00Z",
    "Offers": [
      {
        "Features": null,
        "Id": "119e5d20-61ed-41ec-904b-494dde1444d4",
        "Items": [
          {
            "Id": "4266e8cb-103a-467e-b36c-dc2c5a1c12d8",
            "SalePrice": 15.00,
            "ListPrice": null,
            "Attributes": [
              {
                "Key": "Condition",
                "Value": "Refurbished"
              }
            ],
            "PurchaseLimit": 3
          }
        ],
        "Url": "https://www.woot.com/offers/so-be-it-2009-pinot-noir-5?utm_source=version2&utm_medium=json&utm_campaign=api.woot.com",
        "EstimatedShipDate": {
          "MessagePrefix": "In Stock.",
          "MessageBody": "Ships in 2-3 business days."
        },
        "PercentageRemaining": 100,
        "Photos": [
          {
            "Url": "https://d3gqasl9vmjfd8.cloudfront.net/9a9075be-57f8-46ce-84f9-69215b9249cc.jpg",
            "Width": 588,
            "Height": 441,
            "Tags": [
              "gallery",
              "fullsize-0"
            ]
          }
        ],
        "ShippingMethods": [
          {
            "Name": "Standard",
            "PerOrderAmount": 5.00,
            "PerEventAmount": 0.00,
            "PerItemAmount": 0.00
          }
        ],
        "SoldOut": false,
        "Specs": "<ul>\r\n\t<li>\r\n\t\tEdna Valley: 73%</li>\r\n\t<li>\r\n\t\tSonoma Coast: 27%</li>\r\n\t<li>\r\n\t\tAlcohol: 13.9%</li>\r\n\t<li>...</li></ul>",
        "Subtitle": "Very, Very Advanced English",
        "Teaser": "Welcome, class, to \"English 601: Seemingly Meaningless Turns Of Phrase.\"",
        "Title": "So Be It 2009 Pinot Noir (5)",
        "WriteUp": "<p>You should all be fluent in the English language by now, but may not have mastered some of its more impenetrable...",
        "Stats": null
      }
    ]
  }
]

GET events/{id}

Updated on Mon, 2013-12-02 14:00

Returns an individual event.

Resource URL

http://api.woot.com/2/events/{id}.json

Parameters

key
required
Your public API key. This can be obtained by visiting your applications page.
id
required
The GUID Id of the desired event.
select
optional
multiple
Restricts the returned properties to the specified values. The Id property will always be returned for all objects.

Example

Request

GET http://api.woot.com/2/events/{id}.json?key={yourkey}

Response

{
  "Type": "Daily",
  "Id": "ae74b3fd-c635-421d-ad83-18be98699ff9",
  "Title": "So Be It 2009 Pinot Noir (5)",
  "Site": "www.woot.com",
  "StartDate": "2012-07-06T05:00:00Z",
  "EndDate": "2012-07-07T05:00:00Z",
  "Offers": [
    {
      "Features": null,
      "Id": "119e5d20-61ed-41ec-904b-494dde1444d4",
      "Items": [
        {
          "Id": "4266e8cb-103a-467e-b36c-dc2c5a1c12d8",
          "SalePrice": 15.00,
          "ListPrice": null,
          "Attributes": [
            {
              "Key": "Condition",
              "Value": "Refurbished"
            }
          ],
          "PurchaseLimit": 3
        }
      ],
      "Url": "https://www.woot.com/offers/so-be-it-2009-pinot-noir-5?utm_source=version2&utm_medium=json&utm_campaign=api.woot.com",
      "EstimatedShipDate": {
        "MessagePrefix": "In Stock.",
        "MessageBody": "Ships in 2-3 business days."
      },
      "PercentageRemaining": 100,
      "Photos": [
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/9a9075be-57f8-46ce-84f9-69215b9249cc.jpg",
          "Width": 588,
          "Height": 441,
          "Tags": [
            "gallery",
            "fullsize-0"
          ]
        }
      ],
      "ShippingMethods": [
        {
          "Name": "Standard",
          "PerOrderAmount": 5.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        }
      ],
      "SoldOut": false,
      "Specs": "<ul>\r\n\t<li>\r\n\t\tEdna Valley: 73%</li>\r\n\t<li>\r\n\t\tSonoma Coast: 27%</li>\r\n\t<li>\r\n\t\tAlcohol: 13.9%</li>\r\n\t<li>...</li></ul>",
      "Subtitle": "Very, Very Advanced English",
      "Teaser": "Welcome, class, to \"English 601: Seemingly Meaningless Turns Of Phrase.\"",
      "Title": "So Be It 2009 Pinot Noir (5)",
      "WriteUp": "<p>You should all be fluent in the English language by now, but may not have mastered some of its more impenetrable...",
      "Stats": null
    }
  ]
}

Data Types

Class Hierarchy

Event

A logical grouping of offers on Woot.

PropertyTypeDescription
EndDate DateTime The date the event will end, in UTC. The value will be null if no end date is known.
Id Guid A unique identifier for this event.
Offers Offer[] A list of active offers for the event.
Site String The site on which this event is show.
StartDate DateTime The date that the event started, in UTC.
Title String The title of the event.
Type String A discriminator field that indicates what type of event this object contains.

DailyEvent Subclass of Event

A daily Woot event.

PropertyTypeDescription
EndDate DateTime The date the event will end, in UTC. The value will be null if no end date is known. (Inherited from Event)
Id Guid A unique identifier for this event. (Inherited from Event)
Offers Offer[] A list of active offers for the event. (Inherited from Event)
Site String The site on which this event is show. (Inherited from Event)
StartDate DateTime The date that the event started, in UTC. (Inherited from Event)
Title String The title of the event. (Inherited from Event)
Type String A discriminator field that indicates what type of event this object contains. (Inherited from Event)

Example

{
  "Type": "Daily",
  "Id": "ae74b3fd-c635-421d-ad83-18be98699ff9",
  "Title": "So Be It 2009 Pinot Noir (5)",
  "Site": "www.woot.com",
  "StartDate": "2012-07-06T05:00:00Z",
  "EndDate": "2012-07-07T05:00:00Z",
  "Offers": [
    {
      "Features": null,
      "Id": "119e5d20-61ed-41ec-904b-494dde1444d4",
      "Items": [
        {
          "Id": "4266e8cb-103a-467e-b36c-dc2c5a1c12d8",
          "SalePrice": 15.00,
          "ListPrice": null,
          "Attributes": [
            {
              "Key": "Condition",
              "Value": "Refurbished"
            }
          ],
          "PurchaseLimit": 3
        }
      ],
      "Url": "https://www.woot.com/offers/so-be-it-2009-pinot-noir-5?utm_source=version2&utm_medium=json&utm_campaign=api.woot.com",
      "EstimatedShipDate": {
        "MessagePrefix": "In Stock.",
        "MessageBody": "Ships in 2-3 business days."
      },
      "PercentageRemaining": 100,
      "Photos": [
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/9a9075be-57f8-46ce-84f9-69215b9249cc.jpg",
          "Width": 588,
          "Height": 441,
          "Tags": [
            "gallery",
            "fullsize-0"
          ]
        }
      ],
      "ShippingMethods": [
        {
          "Name": "Standard",
          "PerOrderAmount": 5.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        }
      ],
      "SoldOut": false,
      "Specs": "<ul>\r\n\t<li>\r\n\t\tEdna Valley: 73%</li>\r\n\t<li>\r\n\t\tSonoma Coast: 27%</li>\r\n\t<li>\r\n\t\tAlcohol: 13.9%</li>\r\n\t<li>...</li></ul>",
      "Subtitle": "Very, Very Advanced English",
      "Teaser": "Welcome, class, to \"English 601: Seemingly Meaningless Turns Of Phrase.\"",
      "Title": "So Be It 2009 Pinot Noir (5)",
      "WriteUp": "<p>You should all be fluent in the English language by now, but may not have mastered some of its more impenetrable...",
      "Stats": null
    }
  ]
}

GhostEvent Subclass of Event

A Ghost event.

PropertyTypeDescription
EndDate DateTime The date the event will end, in UTC. The value will be null if no end date is known. (Inherited from Event)
Id Guid A unique identifier for this event. (Inherited from Event)
Offers Offer[] A list of active offers for the event. (Inherited from Event)
Site String The site on which this event is show. (Inherited from Event)
StartDate DateTime The date that the event started, in UTC. (Inherited from Event)
Title String The title of the event. (Inherited from Event)
Type String A discriminator field that indicates what type of event this object contains. (Inherited from Event)

Example

{
  "Type": "Ghost",
  "Id": "a7a73bd0-c507-4fb5-8b46-02e96c7e4172",
  "Title": "Test",
  "Site": "tools.woot.com",
  "StartDate": "2017-06-01T05:00:00Z",
  "EndDate": "2017-06-02T05:00:00Z",
  "Offers": [
    {
      "Features": null,
      "Id": "d89dbf61-b88b-443a-b62e-dff8d67fe3b0",
      "Items": [
        {
          "Id": "0289308c-1e8d-4ce4-ace4-2490f7add84d",
          "SalePrice": 34.99,
          "ListPrice": null,
          "Attributes": [
            {
              "Key": "Condition",
              "Value": "New"
            }
          ],
          "PurchaseLimit": 0
        }
      ],
      "Url": "https://tools.woot.com/offers/red-fuel-power-8000mah-jump-starter-5?ref=w_cnt_lnd_cat_tool_8_4",
      "PercentageRemaining": 0,
      "Photos": [
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/ae716943-9f74-40d4-b83b-10bfb93624bb.jpg",
          "Width": 1080,
          "Height": 410,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/765ff97c-56f5-401a-82d0-211d0bce5db8.jpg",
          "Width": 768,
          "Height": 576,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/7488e7e7-a114-4557-bd2d-cdaf48f83ca1.jpg",
          "Width": 604,
          "Height": 453,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/b4c0136f-8781-4897-bdd2-b474d8754fac.jpg",
          "Width": 380,
          "Height": 285,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/e7358a62-6537-4060-9476-8c574a6a2ba2.jpg",
          "Width": 188,
          "Height": 142,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/2bba3142-64ef-49e4-8cf1-ba99d5d8f84e.jpg",
          "Width": 200,
          "Height": 100,
          "Tags": []
        }
      ],
      "ShippingMethods": [
        {
          "Name": "Standard",
          "PerOrderAmount": 5.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        }
      ],
      "SoldOut": true,
      "Specs": "In the box: Red Fuel Power REDFUELSL161 8000mAh Jump Starter, AC Adapter, Smart Cable/Clamp Set...",
      "Subtitle": "",
      "Teaser": "It's like having god-like power (except only over your car engine)",
      "Title": "Red Fuel Power 8000mAh Jump Starter",
      "WriteUp": "<p>If you could control time, you wouldn't need to worry about your battery going dead. If it did...",
      "Stats": null
    }
  ]
}

MoofiEvent Subclass of Event

A Moofi event.

PropertyTypeDescription
EndDate DateTime The date the event will end, in UTC. The value will be null if no end date is known. (Inherited from Event)
Id Guid A unique identifier for this event. (Inherited from Event)
Offers Offer[] A list of active offers for the event. (Inherited from Event)
Site String The site on which this event is show. (Inherited from Event)
StartDate DateTime The date that the event started, in UTC. (Inherited from Event)
Title String The title of the event. (Inherited from Event)
Type String A discriminator field that indicates what type of event this object contains. (Inherited from Event)

Example

{
  "Type": "Moofi",
  "Id": "061de7a6-1ff4-4539-a190-d375b07574f1",
  "Title": "chumby one: Smart Internet Companion",
  "Site": "www.woot.com",
  "StartDate": "2012-06-30T05:00:00Z",
  "EndDate": "2012-07-05T05:00:00Z",
  "Offers": [
    {
      "Features": null,
      "Id": "9364391e-360b-4280-b219-3922fa50f217",
      "Items": [
        {
          "Id": "7459bf73-8f93-4725-b401-c67c4558ea06",
          "SalePrice": 59.99,
          "ListPrice": null,
          "Attributes": [
            {
              "Key": "Condition",
              "Value": "New"
            }
          ],
          "PurchaseLimit": 0
        }
      ],
      "Url": "https://moofi.woot.com/offers/chumby-one-smart-internet-companion",
      "PercentageRemaining": 90,
      "Photos": [
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/8b8c2869-8c72-4161-9f78-114119c5c0d4.jpg",
          "Width": 1080,
          "Height": 410,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/71ad3cb6-1d16-4ee8-9a6f-b14b7be28181.jpg",
          "Width": 588,
          "Height": 441,
          "Tags": [
            "gallery",
            "fullsize-0"
          ]
        }
      ],
      "ShippingMethods": [
        {
          "Name": "Standard",
          "PerOrderAmount": 5.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        }
      ],
      "SoldOut": false,
      "Specs": "chumby one Smart Internet Companion 3.5\" LCD Touchscreen, FM Tuner, Wi-Fi, over 1,500 Free Apps",
      "Subtitle": "Chumber vs. Chumber",
      "Teaser": "The house is yours. The kids can live with you. You take the Porsche and I'll drive the Acura. But there's no way in Hell I'm going to let you keep the Chumby.",
      "Title": "chumby one: Smart Internet Companion",
      "WriteUp": "<p>If it wasn't for me, you never even would've even looked twice at it.  Remember when...",
      "Stats": null
    }
  ]
}

ReckoningEvent Subclass of Event

A reckoning event. Note that the Offers in a Reckoning event contain a Rank. This is either the rank of the shirt or blank if the shirt is immune from ranking.

PropertyTypeDescription
EndDate DateTime The date the event will end, in UTC. The value will be null if no end date is known. (Inherited from Event)
Id Guid A unique identifier for this event. (Inherited from Event)
Offers Offer[] A list of active offers for the event. (Inherited from Event)
Site String The site on which this event is show. (Inherited from Event)
StartDate DateTime The date that the event started, in UTC. (Inherited from Event)
Title String The title of the event. (Inherited from Event)
Type String A discriminator field that indicates what type of event this object contains. (Inherited from Event)

Example

{
  "Type": "Reckoning",
  "Id": "a1a3d6e0-5374-41f5-b16c-f844f41d147d",
  "Title": "Day of Reckoning #203: July 4, 2011",
  "Site": "shirt.woot.com",
  "StartDate": "2011-07-04T05:00:00Z",
  "EndDate": "2011-06-28T05:00:00Z",
  "Offers": [
    {
      "Features": null,
      "Id": "f494fb8a-8db2-4f26-b71c-9e80069c1d3c",
      "Items": [
        {
          "Id": "11557cb7-958c-49fa-b55b-3afd2f316d24",
          "SalePrice": 15.00,
          "ListPrice": null,
          "Attributes": [
            {
              "Key": "Condition",
              "Value": "verboten"
            },
            {
              "Key": "Size",
              "Value": "L"
            }
          ],
          "PurchaseLimit": 0
        }
      ],
      "Url": "https://shirt.woot.com/offers/forbidden-future",
      "OriginalStartDate": "2017-09-20T05:00:00Z",
      "PercentageRemaining": 100,
      "Photos": [
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/6db01982-35ad-4eac-8b0e-7da593f6edd7.png",
          "Width": 1080,
          "Height": 410,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/704065dd-ad69-484e-8467-41521f7dc71f.png",
          "Width": 588,
          "Height": 441,
          "Tags": [
            "gallery",
            "fullsize-0"
          ]
        }
      ],
      "Rank": 7,
      "ShippingMethods": [
        {
          "Name": "Standard",
          "PerOrderAmount": 0.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        },
        {
          "Name": "Standard International",
          "PerOrderAmount": 0.00,
          "PerEventAmount": 5.00,
          "PerItemAmount": 0.00
        },
        {
          "Name": "One-Day",
          "PerOrderAmount": 0.00,
          "PerEventAmount": 5.00,
          "PerItemAmount": 0.00
        }
      ],
      "SoldOut": false,
      "Specs": "Navy Woot Tee",
      "Subtitle": "This robot is \"robby\" in the sense that he steals stuff.",
      "Teaser": "2nd place in <a href=\"https://shirt.woot.com/Derby/Derby.aspx?n=200\">Derby #200: The Silver Screen</a>, with 831 votes!",
      "Title": "Forbidden Future",
      "WriteUp": "<p>Seriously, <a href=\"http://www.robothalloffame.org/\">Robot Hall of Fame?</a> You inducted R2-D2 <em>and</em> C-3PO before...",
      "Stats": null
    }
  ]
}

WootOffEvent Subclass of Event

A woot-off event!

PropertyTypeDescription
EndDate DateTime The date the event will end, in UTC. The value will be null if no end date is known. (Inherited from Event)
Id Guid A unique identifier for this event. (Inherited from Event)
Offers Offer[] A list of active offers for the event. (Inherited from Event)
Site String The site on which this event is show. (Inherited from Event)
StartDate DateTime The date that the event started, in UTC. (Inherited from Event)
Subtitle String The subtitle for the woot-off event.
Title String The title of the event. (Inherited from Event)
Type String A discriminator field that indicates what type of event this object contains. (Inherited from Event)
WriteUp String The writeup for the woot-off event.

Example

{
  "Subtitle": "Subtitle of WootOff!",
  "WriteUp": null,
  "Type": "WootOff",
  "Id": "0e82b415-4a51-4cea-b711-69a7800119e3",
  "Title": "Wine Woot-Off!",
  "Site": "wine.woot.com",
  "StartDate": "2012-06-26T05:00:00Z",
  "EndDate": null,
  "Offers": [
    {
      "Features": null,
      "Id": "a9fef72d-a193-49c0-b59c-a3e237c445a5",
      "Items": [
        {
          "Id": "8d2f146a-aa4e-4ab1-bf53-67d00b0b24f6",
          "SalePrice": 69.99,
          "ListPrice": 120.00,
          "Attributes": [],
          "PurchaseLimit": 0
        }
      ],
      "Url": "https://www.woot.com/offers/emery-estate-unbridled-cabernet",
      "PercentageRemaining": 0,
      "Photos": [
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/5c5f0a47-d299-44ea-817e-032e7ad26d38.png",
          "Width": 1080,
          "Height": 410,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/a0b4deea-4a19-44a9-94dd-23936a1d718e.png",
          "Width": 588,
          "Height": 441,
          "Tags": [
            "gallery",
            "fullsize-0"
          ]
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/68aa949f-2f46-4c1b-a24f-1dc28350ba84.png",
          "Width": 60,
          "Height": 45,
          "Tags": [
            "gallery",
            "thumbnail-0"
          ]
        }
      ],
      "ShippingMethods": [
        {
          "Name": "Standard",
          "PerOrderAmount": 5.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        }
      ],
      "SoldOut": true,
      "Specs": "<ul><li>Alcohol Content&nbsp; 14.6%</li><li>Cases Produced: 1,100</li><li>RS: 0.30</li><li>...</li></ul>",
      "Subtitle": "It's a weird adjective.",
      "Teaser": "The word \"unbridled\" doesn't always work with every noun.",
      "Title": "Emery Estate Unbridled Cabernet",
      "WriteUp": "At first glance, a phrase like \"unbridled Cabernet\" might sound confusing. But it's a better choice than, say, \"unbridled stomach flu.\" ...",
      "Stats": null
    }
  ]
}

WootPlusEvent Subclass of Event

A Woot Plus event.

PropertyTypeDescription
DiscussionUrl String The discussion URL for the event.
EndDate DateTime The date the event will end, in UTC. The value will be null if no end date is known. (Inherited from Event)
Id Guid A unique identifier for this event. (Inherited from Event)
ManufacturerText String The HTML content of the text describing the manufacturer.
Offers Offer[] A list of active offers for the event. (Inherited from Event)
Photos Photo[] An collection of photos for the event.
Site String The site on which this event is show. (Inherited from Event)
StartDate DateTime The date that the event started, in UTC. (Inherited from Event)
Subtitle String The subtitle of the event.
Text String The HTML content of the description text for the event.
Title String The title of the event. (Inherited from Event)
Type String A discriminator field that indicates what type of event this object contains. (Inherited from Event)
Url String The URL for the woot-plus event.

Example

{
  "Text": "Statistics show that if you're shopping on Shirt.Woot, you probably like cats. That's why this sale is just for you! We've put together...",
  "ManufacturerText": "<header><h1>Shipping Info!</h1></header><article><p>These adorable widdle kitties will make their way to you on July 11!</p></article>",
  "Photos": [
    {
      "Url": "https://d3gqasl9vmjfd8.cloudfront.net/02d18e7b-6ad8-4c8b-9324-205da0dc7199.png",
      "Width": 1080,
      "Height": 300,
      "Tags": []
    }
  ],
  "Subtitle": null,
  "Url": "https://shirt.woot.com/plus/crazy-for-kitties",
  "Type": "WootPlus",
  "Id": "fc5385c6-39f5-46e2-9b3c-45cdcf04e0bd",
  "Title": "Crazy for Kitties!",
  "Site": "shirt.woot.com",
  "StartDate": "2012-07-01T05:00:00Z",
  "EndDate": "2012-07-08T05:00:00Z",
  "Offers": [
    {
      "Features": null,
      "Id": "2160e33e-28cc-4ed0-a862-193227caa860",
      "Items": [
        {
          "Id": "1d26a451-1abe-49af-b6f5-b5df67cbbb77",
          "SalePrice": 35.00,
          "ListPrice": null,
          "Attributes": [
            {
              "Key": "Size",
              "Value": "Small"
            }
          ],
          "PurchaseLimit": 0
        }
      ],
      "Url": "https://shirt.woot.com/offers/schrodingers-equation-lw-hoodie",
      "PercentageRemaining": 100,
      "Photos": [
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/163c3ddd-79cc-4bcb-875b-3cd600049af6.png",
          "Width": 1080,
          "Height": 410,
          "Tags": []
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/bf81f408-248a-4d6a-8d4a-541484fae5b3.png",
          "Width": 588,
          "Height": 441,
          "Tags": [
            "gallery",
            "fullsize-0"
          ]
        },
        {
          "Url": "https://d3gqasl9vmjfd8.cloudfront.net/4241c768-2f50-4faa-b568-46d84d0413c6.png",
          "Width": 60,
          "Height": 45,
          "Tags": [
            "gallery",
            "thumbnail-0"
          ]
        }
      ],
      "ShippingMethods": [
        {
          "Name": "Standard",
          "PerOrderAmount": 0.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        },
        {
          "Name": "One-Day",
          "PerOrderAmount": 5.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        },
        {
          "Name": "Standard International",
          "PerOrderAmount": 5.00,
          "PerEventAmount": 0.00,
          "PerItemAmount": 0.00
        }
      ],
      "SoldOut": false,
      "Specs": null,
      "Subtitle": null,
      "Teaser": null,
      "Title": "Schrodinger's Equation LW Hoodie",
      "WriteUp": null,
      "Stats": null
    }
  ]
}

Offer

A collection of similar items.

PropertyTypeDescription
Artist Artist For Shirt.Woot offers, the artist who created the shirt. Blank if the offer does not have an artist.
DiscussionUrl String The discussion URL for the offer.
EstimatedShipDate EstimatedShipDate An estimated date that the offer will ship.
Features String The features of the items.
Id Guid A unique identifier for this offer.
Items Item[] The list of items available for purchase in the offer.
OriginalStartDate DateTime For offers in The Reckoning, contains the original start date of the shirt. Excluded if the offer is not in the reckoning.
PercentageRemaining Int32 An approximate percentage of the merchandise in an offer.
Photos Photo[] A list of photos for the offer.
QualityPosts QualityPost[] A list of the quality posts in the forum thread for the offer.
Rank Int32 For offers in The Reckoning, contains the rank of the shirt in the Reckoning. Excluded if the shirt is immune from ranking.
ShippingMethods ShippingMethod[] The list of shipping methods available for the offer.
Snippet String The HTML contents of the offer's snippet if it exists.
SoldOut Boolean A value indicating whether or not the offer has sold out.
Specs String The specifications of the items.
Stats OfferStats A collection of OfferStats that describe the offer.
Subtitle String The subtitle of the offer.
Teaser String The teaser of the offer. Displayed as a heading for the write up.
Title String The title of the offer.
Url String The URL where the offer can be viewed.
WineryDetails String The HTML contents of the offer's Winery Details if it exists.
WriteUp String The HTML contents of the offer's write-up.

Example

{
  "Features": null,
  "Id": "119e5d20-61ed-41ec-904b-494dde1444d4",
  "Items": [
    {
      "Id": "4266e8cb-103a-467e-b36c-dc2c5a1c12d8",
      "SalePrice": 15.00,
      "ListPrice": null,
      "Attributes": [
        {
          "Key": "Condition",
          "Value": "Refurbished"
        }
      ],
      "PurchaseLimit": 3
    }
  ],
  "Url": "https://www.woot.com/offers/so-be-it-2009-pinot-noir-5?utm_source=version2&utm_medium=json&utm_campaign=api.woot.com",
  "EstimatedShipDate": {
    "MessagePrefix": "In Stock.",
    "MessageBody": "Ships in 2-3 business days."
  },
  "PercentageRemaining": 100,
  "Photos": [
    {
      "Url": "https://d3gqasl9vmjfd8.cloudfront.net/9a9075be-57f8-46ce-84f9-69215b9249cc.jpg",
      "Width": 588,
      "Height": 441,
      "Tags": [
        "gallery",
        "fullsize-0"
      ]
    }
  ],
  "ShippingMethods": [
    {
      "Name": "Standard",
      "PerOrderAmount": 5.00,
      "PerEventAmount": 0.00,
      "PerItemAmount": 0.00
    }
  ],
  "SoldOut": false,
  "Specs": "<ul>\r\n\t<li>\r\n\t\tEdna Valley: 73%</li>\r\n\t<li>\r\n\t\tSonoma Coast: 27%</li>\r\n\t<li>\r\n\t\tAlcohol: 13.9%</li>\r\n\t<li>...</li></ul>",
  "Subtitle": "Very, Very Advanced English",
  "Teaser": "Welcome, class, to \"English 601: Seemingly Meaningless Turns Of Phrase.\"",
  "Title": "So Be It 2009 Pinot Noir (5)",
  "WriteUp": "<p>You should all be fluent in the English language by now, but may not have mastered some of its more impenetrable...",
  "Stats": null
}

OfferStats

Order statistics for an offer.

PropertyTypeDescription
FirstSucker String The username of the first person to buy this offer.
LastPurchase DateTime The last date and time this offer was purchased.
LastWooterToWoot String The username of the last person to buy this offer.
OverallOrderPace Double How this sale ranks among other Woot sales across all sites, in order pace.
OverallWootsSold Double How this sale ranks among other Woot sales across all sites, in number of woots sold.
PercentageOfSalesPerDay KeyValuePair`2[] The percentage of sales per day for this offer.
PercentageOfSalesPerHour KeyValuePair`2[] The percentage of sales per hour for this offer.
PurchaserExperience KeyValuePair`2[] The percentage of users who bought this offer by number of previous woots.
PurchaserSeniority KeyValuePair`2[] The percentage of users who bought this offer by age of account.
QuantityBreakdown KeyValuePair`2[] The percentage of users who bought this offer by quantity.
SiteOrderPace Double How this sale ranks among other Woot sales on the same site, in order pace.
SiteWootsSold Double How this sale ranks among other Woot sales on the same site, in number of woots sold.
SpeedToFirstWoot TimeSpan The difference in time between when the offer launched and when the first order for this offer was placed.
WootsByState KeyValuePair`2[] The percent ratio of orders in each state.

QualityPost

A forum post that has been spotlighted as a quality post.

PropertyTypeDescription
Avatar String The Url to the user's avatar.
FormattedBody String The HTML formatted text of the forum post.
PostedOn DateTime The date and time this message was posted.
Text String The text of the forum post.
Username String The username of the user who posted this message.

Example

{
  "Avatar": "https://d3i3n97mf62g8s.cloudfront.net/default.png",
  "FormattedBody": "This deal is amazing!",
  "PostedOn": "0001-01-01T00:00:00",
  "Text": "wootbot now praises this deal",
  "Username": "wootbot"
}

Item

The basic unit-of-sale for Woot.

PropertyTypeDescription
Attributes Attribute[] The item's attributes.
Id Guid The unique identifier for this item. This can be used to create purchase URLs.
ListPrice Decimal The list price of the item. If the list price is not known, this value will be null.
PurchaseLimit Int32 The item-level purchase limit. This is the smaller of item quantity remaining and offer-level purchase limit.
SalePrice Decimal The sale price of the item.

Example

{
  "Id": "4266e8cb-103a-467e-b36c-dc2c5a1c12d8",
  "SalePrice": 15.00,
  "ListPrice": null,
  "Attributes": [
    {
      "Key": "Condition",
      "Value": "Refurbished"
    }
  ],
  "PurchaseLimit": 3
}

Attribute

An attribute that can be used to differentiate between the items in an offer. Attributes can describe the size, color, or condition of a product, and so on.

PropertyTypeDescription
Key String The attribute's "key" or "name".
Value String The value of the attribute.

Example

{
  "Key": "Condition",
  "Value": "Refurbished"
}

Photo

Describes a photo.

PropertyTypeDescription
Height Int32 The height, in pixels, of the photo.
Tags String[] A list of tags describing the photo. Absence or existence of the tag "gallery" indicates whether the photo is a main product photo, or a gallery image respectively.
Url String The URL of the photo.
Width Int32 The width, in pixels, of the photo.

Example

{
  "Url": "https://d3gqasl9vmjfd8.cloudfront.net/9a9075be-57f8-46ce-84f9-69215b9249cc.jpg",
  "Width": 588,
  "Height": 441,
  "Tags": [
    "gallery",
    "fullsize-0"
  ]
}

ShippingMethod

Specifies the cost of shipping for an offer.

Shipping charges can be added per order or per item (or both, potentially). The PerItemAmount is added per item quantity, and the PerOrderAmount is added per order.

PropertyTypeDescription
Name String The name of the shipping method.
PerEventAmount Decimal The cost, in USD, attached to each event in an order.
PerItemAmount Decimal The cost, in USD, attached to each item in an order.
PerOrderAmount Decimal The cost, in USD, attached to each order.

Example

{
  "Name": "Standard",
  "PerOrderAmount": 5.00,
  "PerEventAmount": 0.00,
  "PerItemAmount": 0.00
}

EstimatedShipDate

An estimated ship date message.

PropertyTypeDescription
MessageBody String The body of the estimated ship date message.
MessagePrefix String The prefix of the estimated ship date message

Example

{
  "MessagePrefix": "In Stock.",
  "MessageBody": "Ships in 2-3 business days."
}