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 |