This returns a random list of showcase items.
| Header | Data Type | Valid Values | Required | Description |
|---|---|---|---|---|
| Content-Type | string | application/json | YES | The format your data will be sent to our site. |
| X-DevKey | string | string | YES | The devkey assigned to the developer. |
| X-AccessToken | string | string | Optional | The token acquired from a POST to Users/AccessToken. |
NOTE: Variables to place in the query string of the request.
| Parameter | Data Type | Valid Values | Description |
|---|---|---|---|
| Count | integer | positive # between 1 and 300. Default is 25 | Number of showcase items to return |
| Keywords | string | Keywords for search | The keywords to use for search |
If the count is not between 1 and 300, you will receive a 400 BadRequest and a Message Response indicating the reason.
If there are no errors with the input parameters, this call will respond with a 200 OK and the following data as serialized JSON
| Parameter | Data Type | Valid Values | Description |
|---|---|---|---|
| Bids | integer | positive # | Number of bids the item has. |
| BuyNowPrice | decimal | positive # | The "Buy Now" price for an item, if applicable. Will be 0 if a "Buy Now" price is not set |
| CanOffer | boolean | true/false | Does the Item accept Offers? |
| EligibleForImmediateCheckout | boolean | true/false | Whether or not this item can be purchased with a credit card immediately. |
| EndingDate | datetime | Valid ISO 8601 DateTime format | The ending date time of the item in UTC. |
| GTIN | string | Valid GTIN | The Global Trade Item Number (GTIN) of the item. |
| HasBuyNow | boolean | true/false | Does the item have a buy now? |
| HasColor | boolean | true/false | Whether or not this item has the paid Colored Title feature. |
| HasFreedomCoin | boolean | true/false | This item accepts FreedomCoin and User can buy with FreedomCoin. Note - this will only be returned for users that allowed to buy with FreedomCoin. |
| HasPictures | boolean | true/false | Does the item have pictures? |
| HasReserve | boolean | true/false | Does the item have reserve price? |
| HasReserveBeenMet | boolean | true/false | Has the reserved been meet on this item? |
| IsFeaturedItem | boolean | true/false | Is this item featured? |
| IsFixedPrice | boolean | true/false | Is this item a fixed price item? |
| IsHighlighted | boolean | true/false | Whether or not this item has the paid Highlight feature. |
| IsShowCaseItem | boolean | true/false | Whether or not this item has the paid Showcase Listing feature. |
| IsTitleBoldface | boolean | true/false | Whether or not this item has the paid Boldface Title feature. |
| ItemID | integer | positive # | id belonging to item |
| MfgPartNumber | string | string | The manufacturing part number. |
| Price | decimal | positive # | The current cost of an item. |
| Quantity | integer | positive # | The number of items for sale for this item. |
| Seller | User Summary | User Summary | The User Summary for the item. |
| SerialNumber | string | string | The serial number of the item |
| SKU | string | string | The SKU of the item. |
| SponsoredListing | integer | bitwise enumeration | Allows searching for items that are viewable on one or more sponsored sites using a bitwise sum |
| SponsoredOnsiteListing | boolean | true/false | Allow searching for items that have been sponsored on GunBroker.com. |
| SubTitle | string | string | The subtitle of an item. |
| ThumbnailURL | string | A fully qualified url to an image file. | The location of the image file to be used as the thumbnail for the item. |
| Title | string | string | The title of the item. |
| TitleColor | string | Valid hex color strings (ex: #000000) | The color of the item title. If the paid feature isn't available, black (#000000) will be returned. |
| Rel | Description | Condition |
|---|---|---|
| self | The item details |