Products

HTTP Request

GET https://marketplace.vin65.com/products

Header Parameters

Query Parameters

NOTE: Supplying multiple search criteria, performs a query using AND operators. Searching for /products?name=apple&brand=peach will return products with a name of apple AND and brand of peach.

Example Request Code

• cURL
• Ruby

curl -X "GET" "https://marketplace.vin65.com/products?name=Chardonnay" \
    -H "Authorization: Bearer your_auth_token_here" \
    -H "Accept: version=1"

require 'httparty'
headers = { "Authorization":"Bearer #{auth_token}" }
response = HTTParty.get(https://marketplace.vin65.com/products?name=grape, headers: headers)
JSON.parse(response.body)

Example Response Headers

HTTP/1.1 200 OK
Cache-Control: max-age=0, private, must-revalidate
Content-Type: application/json; charset=utf-8
Date: Thu, 04 Feb 2016 21:00:49 GMT
ETag: W/"cf04ad3e655386a9d21e7e82d7fa7755"
Server: nginx/1.4.6 (Ubuntu)
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
X-Page: 1
X-Per-Page: 7
X-Request-Id: d99dfcbc-016e-4e5e-a119-220d7356dee0
X-Runtime: 0.534159
X-Total: 7
X-Version: 1
X-XSS-Protection: 1; mode=block
transfer-encoding

Example Response Body

{
  "products": [{
    "id": 5,
    "sku_uuid": "9FBDF2A7-DAA6-CB1D-2682-78AD23DD2EAF",
    "product_uuid": "9FBDEBAC-B252-79D7-16FA-01F21E55458D",
    "sku": "2008Chardonnay",
    "name": "2008 Chardonnay Bundle",
    "alcohol_percent": 10.0,
    "brand": "Solstice",
    "description": "This is a product description",
    "retail_price": 99.99,
    "marketplace_price": 89.99,
    "inventory": 200,
    "available_inventory": 150,
    "product_type": "bundle",
    "region": "California",
    "status": "available",
    "teaser": "This is the product teaser",
    "varietal": "Chardonnay",
    "vintage": 2007,
    "volume_in_liters": 0.75,
    "weight_in_kg": 1.36078,
    "acid": 9.6,
    "appellation": "Paso Robles",
    "bottling_date": "2008-04-28T00:00:00.000Z",
    "fermentation": 0.0,
    "harvest_date": "2005-04-09T00:00:00.000Z",
    "ph": 31.0,
    "production_amount": "259 Cases",
    "residual_sugar": 218.0,
    "sugar": 3.0,
    "tannin": 12.6,
    "wine_type": "White Wine",
    "unit_description": "Bottle",
    "vineyard_designation": "Generic Vineyard",
    "sparkling": "false",
    
    "primary_image_url": "http://www.example.com/image.jpg",
    "url": "htttp://www.example.com/products/product.html",  
    "vivino_id": 123456789,
    "vivino_rating": 4.5,
    "display_bundled_products": true,
    "giftset": false,
    "bottles": 6,
    "status_changed_at": "2008-04-28T00:00:00.000Z",
    "winery": {
      "name": "Test Winery 2",
      "address": "24732 Vine Drive, Napa, CA, 94510, US"
    },
    "jurisdictions": [{
      "name": "Alaska",
      "abbr": "AK"
    }, {
      "name": "Arizona",
      "abbr": "AZ"
    }, {
      "name": "California",
      "abbr": "CA"
    }],
    "images": [{
      "filename": "yellow_bottle1.png",
      "content_type": "image/png",
      "file_size": 60970,
      "image_type": 'bottle_shot',
      "url": "https://s3-us-west-2.amazonaws.com/vin65-product-images/images/files/000/000/003/original/yellow_bottle1.png?1453504454"
    }, {
      "filename": "yellow_bottle2.png",
      "content_type": "image/png",
      "file_size": 60970,
      "image_type": 'bottle_shot',
      "url": "https://s3-us-west-2.amazonaws.com/vin65-product-images/images/files/000/000/004/original/yellow_bottle2.png?1453504477"
    }],
    "notes": [{
      "name": "vineyardNotes",
      "content": "Nulla sit amet aliquam sem. Aenean vehicula vestibulum augue, eu ornare ipsum viverra et."
    }, {
      "name": "productionNotes",
      "content": "Nulla sit amet aliquam sem. Aenean vehicula vestibulum augue, eu ornare ipsum viverra et."
    }],
    "ratings": [{
      "code": "VORating",
      "name": "Vivino",
      "score": "4.3",
      "content": "4.3",
      "review": null,
      "entries": 328,
      "rating_type": "community",
      "abbr": "VO"
    }, {
      "code": "WBRating",
      "name": "Wine Buyer",
      "score": "90",
      "content": "90",
      "review": null,
      "entries": null,
      "rating_type": "professional",
      "abbr": "WB"
    }],
    "bundled_products": [{
      "id": 123,
      "sku": "yolo10",
      "name": "Yolo Chard",
      "brand": "Yolo",
      "url": "htttp://www.example.com/products/yoyo10.html",
      "marketplace_price": 19.99,
      "quantity": 6,
      "inventory": 600,
      "bottles": 1,
      "product_type": "wine",
      "individually_sellable": false,
      "volume_in_liters": 0.75,
      "alcohol_percent": 13.5,
      "region": "California",
      "appellation": "Paso Robles",
      "wine_type": "White Wine",
      "vintage": 2022,
      "teaser": "This is the product teaser",
      "description": "This is the product description",
      "status": "available",
      "ratings": [{
        "code": "VORating",
        "name": "Vivino",
        "score": "4.3",
        "content": "4.3",
        "review": null,
        "entries": 328,
        "rating_type": "community",
        "abbr": "VO"
      }],
      "notes": [{
        "name": "vineyardNotes",
        "content": "Nulla sit amet aliquam sem. Aenean vehicula vestibulum augue, eu ornare ipsum viverra et."
      }]  
    }]
  }]
}

Response Data