wordpress之woocommer手册---product产品篇

今天药忘吃喽~ 2022-11-06 14:52 227阅读 0赞

# Products #

This section lists all API that can be used to create, edit or otherwise manipulate products.

## Products Properties ##

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>title</code></td> 
   <td>string</td> 
   <td>Product name</td> 
  </tr> 
  <tr> 
   <td><code>id</code></td> 
   <td>integer</td> 
   <td>Product ID (post ID) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>created_at</code></td> 
   <td>string</td> 
   <td>UTC DateTime when the product was created <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>updated_at</code></td> 
   <td>string</td> 
   <td>UTC DateTime when the product was last updated <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>type</code></td> 
   <td>string</td> 
   <td>Product type. By default in WooCommerce the following types are available: <code>simple</code>, <code>grouped</code>, <code>external</code>, <code>variable</code>. Default is <code>simple</code></td> 
  </tr> 
  <tr> 
   <td><code>status</code></td> 
   <td>string</td> 
   <td>Product status (post status). Default is <code>publish</code></td> 
  </tr> 
  <tr> 
   <td><code>downloadable</code></td> 
   <td>boolean</td> 
   <td>If the product is downloadable or not. Downloadable products give access to a file upon purchase</td> 
  </tr> 
  <tr> 
   <td><code>virtual</code></td> 
   <td>boolean</td> 
   <td>If the product is virtual or not. Virtual products are intangible and aren’t shipped</td> 
  </tr> 
  <tr> 
   <td><code>permalink</code></td> 
   <td>string</td> 
   <td>Product URL (post permalink) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>sku</code></td> 
   <td>string</td> 
   <td>SKU refers to a Stock-keeping unit, a unique identifier for each distinct product and service that can be purchased</td> 
  </tr> 
  <tr> 
   <td><code>price</code></td> 
   <td>float</td> 
   <td>Current product price. This is setted from <code>regular_price</code> and <code>sale_price</code> <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>regular_price</code></td> 
   <td>float</td> 
   <td>Product regular price</td> 
  </tr> 
  <tr> 
   <td><code>sale_price</code></td> 
   <td>float</td> 
   <td>Product sale price</td> 
  </tr> 
  <tr> 
   <td><code>sale_price_dates_from</code></td> 
   <td>float</td> 
   <td>Sets the sale start date. Date in the <code>YYYY-MM-DD</code> format <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>sale_price_dates_to</code></td> 
   <td>float</td> 
   <td>Sets the sale end date. Date in the <code>YYYY-MM-DD</code> format <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>price_html</code></td> 
   <td>string</td> 
   <td>Price formatted in HTML, e.g. <code>&lt;del&gt;&lt;span class=\"amount\"&gt;&amp;#36;&amp;nbsp;3.00&lt;/span&gt;&lt;/del&gt; &lt;ins&gt;&lt;span class=\"amount\"&gt;&amp;#36;&amp;nbsp;2.00&lt;/span&gt;&lt;/ins&gt;</code> <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>taxable</code></td> 
   <td>boolean</td> 
   <td>Show if the product is taxable or not <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>tax_status</code></td> 
   <td>string</td> 
   <td>Tax status. The options are: <code>taxable</code>, <code>shipping</code> (Shipping only) and <code>none</code></td> 
  </tr> 
  <tr> 
   <td><code>tax_class</code></td> 
   <td>string</td> 
   <td>Tax class</td> 
  </tr> 
  <tr> 
   <td><code>managing_stock</code></td> 
   <td>boolean</td> 
   <td>Enable stock management at product level</td> 
  </tr> 
  <tr> 
   <td><code>stock_quantity</code></td> 
   <td>integer</td> 
   <td>Stock quantity. If is a variable product this value will be used to control stock for all variations, unless you define stock at variation level.</td> 
  </tr> 
  <tr> 
   <td><code>in_stock</code></td> 
   <td>boolean</td> 
   <td>Controls whether or not the product is listed as “in stock” or “out of stock” on the frontend.</td> 
  </tr> 
  <tr> 
   <td><code>backorders_allowed</code></td> 
   <td>boolean</td> 
   <td>Shows if backorders are allowed <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>backordered</code></td> 
   <td>boolean</td> 
   <td>Shows if a product is on backorder (if the product have the stock_quantity negative) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>backorders</code></td> 
   <td>mixed</td> 
   <td>If managing stock, this controls whether or not backorders are allowed. If enabled, stock quantity can go below 0. The options are: <code>false</code> (Do not allow), <code>notify</code> (Allow, but notify customer), and <code>true</code> (Allow) <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>sold_individually</code></td> 
   <td>boolean</td> 
   <td>When <code>true</code> this only allow one item to be bought in a single order</td> 
  </tr> 
  <tr> 
   <td><code>purchaseable</code></td> 
   <td>boolean</td> 
   <td>Shows if the product can be bought <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>featured</code></td> 
   <td>boolean</td> 
   <td>Featured Product</td> 
  </tr> 
  <tr> 
   <td><code>visible</code></td> 
   <td>boolean</td> 
   <td>Shows whether or not the product is visible in the catalog <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>catalog_visibility</code></td> 
   <td>string</td> 
   <td>Catalog visibility. The following options are available: <code>visible</code> (Catalog and search), <code>catalog</code> (Only in catalog), <code>search</code> (Only in search) and <code>hidden</code> (Hidden from all). Default is <code>visible</code></td> 
  </tr> 
  <tr> 
   <td><code>on_sale</code></td> 
   <td>boolean</td> 
   <td>Shows if the product is on sale or not <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>weight</code></td> 
   <td>string</td> 
   <td>Product weight in decimal format</td> 
  </tr> 
  <tr> 
   <td><code>dimensions</code></td> 
   <td>array</td> 
   <td>List of the product dimensions. See <a rel="nofollow">Dimensions Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>shipping_required</code></td> 
   <td>boolean</td> 
   <td>Shows if the product need to be shipped or not <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>shipping_taxable</code></td> 
   <td>boolean</td> 
   <td>Shows whether or not the product shipping is taxable <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>shipping_class</code></td> 
   <td>string</td> 
   <td>Shipping class slug. Shipping classes are used by certain shipping methods to group similar products</td> 
  </tr> 
  <tr> 
   <td><code>shipping_class_id</code></td> 
   <td>integer</td> 
   <td>Shipping class ID <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>description</code></td> 
   <td>string</td> 
   <td>Product description</td> 
  </tr> 
  <tr> 
   <td><code>enable_html_description</code></td> 
   <td>bool</td> 
   <td>Enable HTML for product description <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>short_description</code></td> 
   <td>string</td> 
   <td>Product short description</td> 
  </tr> 
  <tr> 
   <td><code>enable_html_short_description</code></td> 
   <td>string</td> 
   <td>Enable HTML for product short description <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>reviews_allowed</code></td> 
   <td>boolean</td> 
   <td>Shows/define if reviews are allowed</td> 
  </tr> 
  <tr> 
   <td><code>average_rating</code></td> 
   <td>string</td> 
   <td>Reviews average rating <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>rating_count</code></td> 
   <td>integer</td> 
   <td>Amount of reviews that the product have <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>related_ids</code></td> 
   <td>array</td> 
   <td>List of related products IDs (<code>integer</code>) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>upsell_ids</code></td> 
   <td>array</td> 
   <td>List of up-sell products IDs (<code>integer</code>). Up-sells are products which you recommend instead of the currently viewed product, for example, products that are more profitable or better quality or more expensive</td> 
  </tr> 
  <tr> 
   <td><code>cross_sell_ids</code></td> 
   <td>array</td> 
   <td>List of cross-sell products IDs. Cross-sells are products which you promote in the cart, based on the current product</td> 
  </tr> 
  <tr> 
   <td><code>parent_id</code></td> 
   <td>integer</td> 
   <td>Product parent ID (post_parent)</td> 
  </tr> 
  <tr> 
   <td><code>categories</code></td> 
   <td>array</td> 
   <td>List of product categories names (<code>string</code>). In write-mode need to pass a array of categories IDs (<code>integer</code>) (<a href="http://codex.wordpress.org/Function_Reference/wp_set_object_terms" rel="nofollow">uses wp_set_object_terms()</a>)</td> 
  </tr> 
  <tr> 
   <td><code>tags</code></td> 
   <td>array</td> 
   <td>List of product tags names (<code>string</code>). In write-mode need to pass a array of tags IDs (<code>integer</code>) (<a href="http://codex.wordpress.org/Function_Reference/wp_set_object_terms" rel="nofollow">uses wp_set_object_terms()</a>)</td> 
  </tr> 
  <tr> 
   <td><code>images</code></td> 
   <td>array</td> 
   <td>List of products images. See <a rel="nofollow">Images Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>featured_src</code></td> 
   <td>string</td> 
   <td>Featured image URL <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>attributes</code></td> 
   <td>array</td> 
   <td>List of product attributes. See <a rel="nofollow">Attributes Properties</a>. Note: the attribute must be registered in WooCommerce before.</td> 
  </tr> 
  <tr> 
   <td><code>default_attributes</code></td> 
   <td>array</td> 
   <td>Defaults variation attributes. These are the attributes that will be pre-selected on the frontend. See <a rel="nofollow">Default Attributes Properties</a> <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>downloads</code></td> 
   <td>array</td> 
   <td>List of downloadable files. See <a rel="nofollow">Downloads Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>download_limit</code></td> 
   <td>integer</td> 
   <td>Amount of times the product can be downloaded. In write-mode you can sent a blank string for unlimited re-downloads. e.g <code>''</code></td> 
  </tr> 
  <tr> 
   <td><code>download_expiry</code></td> 
   <td>integer</td> 
   <td>Number of days that the customer has up to be able to download the product. In write-mode you can sent a blank string for never expiry. e.g <code>''</code></td> 
  </tr> 
  <tr> 
   <td><code>download_type</code></td> 
   <td>string</td> 
   <td>Download type, this controls the <a href="http://schema.org/" rel="nofollow">schema</a>. The available options are: <code>''</code> (Standard Product), <code>application</code> (Application/Software) and <code>music</code> (Music)</td> 
  </tr> 
  <tr> 
   <td><code>purchase_note</code></td> 
   <td>string</td> 
   <td>Optional note to send the customer after purchase.</td> 
  </tr> 
  <tr> 
   <td><code>total_sales</code></td> 
   <td>integer</td> 
   <td>Amount of sales <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>variations</code></td> 
   <td>array</td> 
   <td>List of products variations. See <a rel="nofollow">Variations Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>parent</code></td> 
   <td>array</td> 
   <td>List the product parent data when query for a variation <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>product_url</code></td> 
   <td>string</td> 
   <td>Product external URL. Only for <code>external</code> products <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>button_text</code></td> 
   <td>string</td> 
   <td>Product external button text. Only for <code>external</code> products <i>write-only</i></td> 
  </tr> 
 </tbody> 
</table>

### Dimensions Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>length</code></td> 
   <td>string</td> 
   <td>Product length in decimal format</td> 
  </tr> 
  <tr> 
   <td><code>width</code></td> 
   <td>string</td> 
   <td>Product width in decimal format</td> 
  </tr> 
  <tr> 
   <td><code>height</code></td> 
   <td>string</td> 
   <td>Product height in decimal format</td> 
  </tr> 
  <tr> 
   <td><code>unit</code></td> 
   <td>string</td> 
   <td>Product name <i>read-only</i></td> 
  </tr> 
 </tbody> 
</table>

### Images Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>id</code></td> 
   <td>integer</td> 
   <td>Image ID (attachment ID)</td> 
  </tr> 
  <tr> 
   <td><code>created_at</code></td> 
   <td>string</td> 
   <td>UTC DateTime when the image was created <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>updated_at</code></td> 
   <td>string</td> 
   <td>UTC DateTime when the image was last updated <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>src</code></td> 
   <td>string</td> 
   <td>Image URL. In write-mode you can use to send new images</td> 
  </tr> 
  <tr> 
   <td><code>title</code></td> 
   <td>string</td> 
   <td>Image title (attachment title) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>alt</code></td> 
   <td>string</td> 
   <td>Image alt text (attachment image alt text) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>position</code></td> 
   <td>integer</td> 
   <td>Image position. <code>0</code> means that the image is featured</td> 
  </tr> 
 </tbody> 
</table>

### Attributes Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>name</code></td> 
   <td>string</td> 
   <td>Attribute name <i>required</i></td> 
  </tr> 
  <tr> 
   <td><code>slug</code></td> 
   <td>string</td> 
   <td>Attribute slug</td> 
  </tr> 
  <tr> 
   <td><code>position</code></td> 
   <td>integer</td> 
   <td>Attribute position</td> 
  </tr> 
  <tr> 
   <td><code>visible</code></td> 
   <td>boolean</td> 
   <td>Shows/define if the attribute is visible on the “Additional Information” tab in the product’s page</td> 
  </tr> 
  <tr> 
   <td><code>variation</code></td> 
   <td>boolean</td> 
   <td>Shows/define if the attribute can be used as variation</td> 
  </tr> 
  <tr> 
   <td><code>options</code></td> 
   <td>array</td> 
   <td>List of available term names of the attribute</td> 
  </tr> 
 </tbody> 
</table>

### Default Attributes Properties ###

### Downloads Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>id</code></td> 
   <td>string</td> 
   <td>File ID (file md5 hash) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>name</code></td> 
   <td>string</td> 
   <td>File name</td> 
  </tr> 
  <tr> 
   <td><code>file</code></td> 
   <td>string</td> 
   <td>File URL. In write-mode you can use this property to send new files</td> 
  </tr> 
 </tbody> 
</table>

### Variations Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>id</code></td> 
   <td>integer</td> 
   <td>Variation ID (post ID) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>created_at</code></td> 
   <td>string</td> 
   <td>UTC DateTime when the variation was created <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>updated_at</code></td> 
   <td>string</td> 
   <td>UTC DateTime when the variation was last updated <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>downloadable</code></td> 
   <td>boolean</td> 
   <td>If the variation is downloadable or not. Downloadable variations give access to a file upon purchase</td> 
  </tr> 
  <tr> 
   <td><code>virtual</code></td> 
   <td>boolean</td> 
   <td>If the variation is virtual or not. Virtual variations are intangible and aren’t shipped</td> 
  </tr> 
  <tr> 
   <td><code>permalink</code></td> 
   <td>string</td> 
   <td>Variation URL (post permalink) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>sku</code></td> 
   <td>string</td> 
   <td>SKU refers to a Stock-keeping unit, a unique identifier for each distinct product and service that can be purchased</td> 
  </tr> 
  <tr> 
   <td><code>price</code></td> 
   <td>float</td> 
   <td>Current variation price. This is setted from <code>regular_price</code> and <code>sale_price</code> <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>regular_price</code></td> 
   <td>float</td> 
   <td>Variation regular price</td> 
  </tr> 
  <tr> 
   <td><code>sale_price</code></td> 
   <td>float</td> 
   <td>Variation sale price</td> 
  </tr> 
  <tr> 
   <td><code>sale_price_dates_from</code></td> 
   <td>float</td> 
   <td>Sets the sale start date. Date in the <code>YYYY-MM-DD</code> format <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>sale_price_dates_to</code></td> 
   <td>float</td> 
   <td>Sets the sale end date. Date in the <code>YYYY-MM-DD</code> format <i>write-only</i></td> 
  </tr> 
  <tr> 
   <td><code>taxable</code></td> 
   <td>boolean</td> 
   <td>Show if the variation is taxable or not <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>tax_status</code></td> 
   <td>string</td> 
   <td>Tax status. The options are: <code>taxable</code>, <code>shipping</code> (Shipping only) and <code>none</code></td> 
  </tr> 
  <tr> 
   <td><code>tax_class</code></td> 
   <td>string</td> 
   <td>Tax class</td> 
  </tr> 
  <tr> 
   <td><code>managing_stock</code></td> 
   <td>boolean</td> 
   <td>Enable stock management at variation level</td> 
  </tr> 
  <tr> 
   <td><code>stock_quantity</code></td> 
   <td>integer</td> 
   <td>Stock quantity. If is a variable variation this value will be used to control stock for all variations, unless you define stock at variation level.</td> 
  </tr> 
  <tr> 
   <td><code>in_stock</code></td> 
   <td>boolean</td> 
   <td>Controls whether or not the variation is listed as “in stock” or “out of stock” on the frontend.</td> 
  </tr> 
  <tr> 
   <td><code>backordered</code></td> 
   <td>boolean</td> 
   <td>Shows if a variation is on backorder (if the variation have the stock_quantity negative) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>purchaseable</code></td> 
   <td>boolean</td> 
   <td>Shows if the variation can be bought <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>visible</code></td> 
   <td>boolean</td> 
   <td>Shows whether or not the product parent is visible in the catalog <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>on_sale</code></td> 
   <td>boolean</td> 
   <td>Shows if the variation is on sale or not <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>weight</code></td> 
   <td>string</td> 
   <td>Variation weight in decimal format</td> 
  </tr> 
  <tr> 
   <td><code>dimensions</code></td> 
   <td>array</td> 
   <td>List of the variation dimensions. See <a rel="nofollow">Dimensions Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>shipping_class</code></td> 
   <td>string</td> 
   <td>Shipping class slug. Shipping classes are used by certain shipping methods to group similar products</td> 
  </tr> 
  <tr> 
   <td><code>shipping_class_id</code></td> 
   <td>integer</td> 
   <td>Shipping class ID <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>images</code></td> 
   <td>array</td> 
   <td>Variation featured image. See <a rel="nofollow">Images Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>attributes</code></td> 
   <td>array</td> 
   <td>List of variation attributes. Similar to a <code>simple</code> or <code>variable</code> product, but for <code>variation</code> indicate the attributes used to form the variation. See <a rel="nofollow">Attributes Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>downloads</code></td> 
   <td>array</td> 
   <td>List of downloadable files. See <a rel="nofollow">Downloads Properties</a></td> 
  </tr> 
  <tr> 
   <td><code>download_limit</code></td> 
   <td>integer</td> 
   <td>Amount of times the variation can be downloaded. In write-mode you can sent a blank string for unlimited re-downloads. e.g <code>''</code></td> 
  </tr> 
  <tr> 
   <td><code>download_expiry</code></td> 
   <td>integer</td> 
   <td>Number of days that the customer has up to be able to download the varition. In write-mode you can sent a blank string for never expiry. e.g <code>''</code></td> 
  </tr> 
 </tbody> 
</table>

## Create A Product ##

This API helps you to create a new product.

### HTTP Request ###

*POST*

###### /wc-api/v3/products ######

> Example of how to create a `simple` product:

curl -X POST https://example.com/wc-api/v3/products \
    	-u consumer_key:consumer_secret \
    	-H "Content-Type: application/json" \
    	-d '{ "product": { "title": "Premium Quality", "type": "simple", "regular_price": "21.99", "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.", "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.", "categories": [ 9, 14 ], "images": [ { "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg", "position": 0 }, { "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg", "position": 1 } ] } }'

data = { 
        "product": { 
            "title": "Premium Quality",
            "type": "simple",
            "regular_price": "21.99",
            "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
            "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
            "categories": [
                9,
                14
            ],
            "images": [
                { 
                    "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
                    "position": 0
                },
                { 
                    "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
                    "position": 1
                }
            ]
        }
    }
    
    print(wcapi.post("products", data).json())

data = { 
      product: { 
        title: "Premium Quality",
        type: "simple",
        regular_price: "21.99",
        description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
        short_description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
        categories: [
          9,
          14
        ],
        images: [
          { 
            src: "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
            position: 0
          },
          { 
            src: "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
            position: 1
          }
        ]
      }
    }
    
    woocommerce.post("products", data).parsed_response

> JSON response example:

{ 
      "product": { 
        "title": "Premium Quality",
        "id": 546,
        "created_at": "2015-01-22T19:46:16Z",
        "updated_at": "2015-01-22T19:46:16Z",
        "type": "simple",
        "status": "publish",
        "downloadable": false,
        "virtual": false,
        "permalink": "https://example.com/product/premium-quality/",
        "sku": "",
        "price": "21.99",
        "regular_price": "21.99",
        "sale_price": null,
        "price_html": "<span class=\"amount\">$ 21.99</span>",
        "taxable": true,
        "tax_status": "taxable",
        "tax_class": "",
        "managing_stock": false,
        "stock_quantity": 0,
        "in_stock": true,
        "backorders_allowed": false,
        "backordered": false,
        "sold_individually": false,
        "purchaseable": true,
        "featured": false,
        "visible": true,
        "catalog_visibility": "visible",
        "on_sale": false,
        "weight": null,
        "dimensions": { 
          "length": "",
          "width": "",
          "height": "",
          "unit": "cm"
        },
        "shipping_required": true,
        "shipping_taxable": true,
        "shipping_class": "",
        "shipping_class_id": null,
        "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
        "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
        "reviews_allowed": true,
        "average_rating": "0.00",
        "rating_count": 0,
        "related_ids": [
          37,
          47,
          31,
          19,
          22
        ],
        "upsell_ids": [],
        "cross_sell_ids": [],
        "parent_id": 0,
        "categories": [
          "Clothing",
          "T-shirts"
        ],
        "tags": [],
        "images": [
          { 
            "id": 547,
            "created_at": "2015-01-22T19:46:16Z",
            "updated_at": "2015-01-22T19:46:16Z",
            "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
            "title": "",
            "alt": "",
            "position": 0
          },
          { 
            "id": 548,
            "created_at": "2015-01-22T19:46:17Z",
            "updated_at": "2015-01-22T19:46:17Z",
            "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
            "title": "",
            "alt": "",
            "position": 1
          }
        ],
        "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
        "attributes": [],
        "downloads": [],
        "download_limit": 0,
        "download_expiry": 0,
        "download_type": "",
        "purchase_note": "",
        "total_sales": 0,
        "variations": [],
        "parent": []
      }
    }

> Example of how to create a `variable` product:

curl -X POST https://example.com/wc-api/v3/products \
    	-u consumer_key:consumer_secret \
    	-H "Content-Type: application/json" \
    	-d '{ "product": { "title": "Ship Your Idea", "type": "variable", "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.", "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.", "categories": [ 9, 14 ], "images": [ { "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg", "position": 0 }, { "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg", "position": 1 }, { "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg", "position": 2 }, { "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg", "position": 3 } ], "attributes": [ { "name": "Color", "slug": "color", "position": "0", "visible": false, "variation": true, "options": [ "Black", "Green" ] } ], "default_attributes": [ { "name": "Color", "slug": "color", "option": "Black" } ], "variations": [ { "regular_price": "19.99", "image": [ { "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg", "position": 0 } ], "attributes": [ { "name": "Color", "slug": "color", "option": "black" } ] }, { "regular_price": "19.99", "image": [ { "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg", "position": 0 } ], "attributes": [ { "name": "Color", "slug": "color", "option": "green" } ] } ] } }'

data = { 
        "product": { 
            "title": "Ship Your Idea",
            "type": "variable",
            "description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
            "short_description": "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
            "categories": [
                9,
                14
            ],
            "images": [
                { 
                    "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
                    "position": 0
                },
                { 
                    "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
                    "position": 1
                },
                { 
                    "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
                    "position": 2
                },
                { 
                    "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
                    "position": 3
                }
            ],
            "attributes": [
                { 
                    "name": "Color",
                    "slug": "color",
                    "position": "0",
                    "visible": False,
                    "variation": True,
                    "options": [
                        "Black",
                        "Green"
                    ]
                }
            ],
            "default_attributes": [
                { 
                    "name": "Color",
                    "slug": "color",
                    "option": "Black"
                }
            ],
            "variations": [
                { 
                    "regular_price": "19.99",
                    "image": [
                        { 
                            "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
                            "position": 0
                        }
                    ],
                    "attributes": [
                        { 
                            "name": "Color",
                            "slug": "color",
                            "option": "black"
                        }
                    ]
                },
                { 
                    "regular_price": "19.99",
                    "image": [
                        { 
                            "src": "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
                            "position": 0
                        }
                    ],
                    "attributes": [
                        { 
                            "name": "Color",
                            "slug": "color",
                            "option": "green"
                        }
                    ]
                }
            ]
        }
    }
    
    print(wcapi.post("products", data).json())

data = { 
      product: { 
        title: "Ship Your Idea",
        type: "variable",
        description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.",
        short_description: "Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
        categories: [
          9,
          14
        ],
        images: [
          { 
            src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
            position: 0
          },
          { 
            src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
            position: 1
          },
          { 
            src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
            position: 2
          },
          { 
            src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
            position: 3
          }
        ],
        attributes: [
          { 
            name: "Color",
            slug: "color",
            position: "0",
            visible: false,
            variation: true,
            options: [
              "Black",
              "Green"
            ]
          }
        ],
        default_attributes: [
          { 
            name: "Color",
            slug: "color",
            option: "Black"
          }
        ],
        variations: [
          { 
            regular_price: "19.99",
            image: [
              { 
                src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
                position: 0
              }
            ],
            attributes: [
              { 
                name: "Color",
                slug: "color",
                option: "black"
              }
            ]
          },
          { 
            regular_price: "19.99",
            image: [
              { 
                src: "http://example.com/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
                position: 0
              }
            ],
            attributes: [
              { 
                name: "Color",
                slug: "color",
                option: "green"
              }
            ]
          }
        ]
      }
    }
    
    woocommerce.post("products", data).parsed_response

> JSON response example:

{ 
      "product": { 
        "title": "Ship Your Idea",
        "id": 604,
        "created_at": "2015-01-22T20:37:14Z",
        "updated_at": "2015-01-22T20:37:14Z",
        "type": "variable",
        "status": "publish",
        "downloadable": false,
        "virtual": false,
        "permalink": "https://example/product/ship-your-idea/",
        "sku": "",
        "price": "19.99",
        "regular_price": "0.00",
        "sale_price": null,
        "price_html": "<span class=\"amount\">$ 19.99</span>",
        "taxable": true,
        "tax_status": "taxable",
        "tax_class": "",
        "managing_stock": false,
        "stock_quantity": 0,
        "in_stock": true,
        "backorders_allowed": false,
        "backordered": false,
        "sold_individually": false,
        "purchaseable": true,
        "featured": false,
        "visible": true,
        "catalog_visibility": "visible",
        "on_sale": false,
        "weight": null,
        "dimensions": { 
          "length": "",
          "width": "",
          "height": "",
          "unit": "cm"
        },
        "shipping_required": true,
        "shipping_taxable": true,
        "shipping_class": "",
        "shipping_class_id": null,
        "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
        "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
        "reviews_allowed": true,
        "average_rating": "0.00",
        "rating_count": 0,
        "related_ids": [
          40,
          37,
          47,
          577,
          34
        ],
        "upsell_ids": [],
        "cross_sell_ids": [],
        "parent_id": 0,
        "categories": [
          "Clothing",
          "T-shirts"
        ],
        "tags": [],
        "images": [
          { 
            "id": 605,
            "created_at": "2015-01-22T20:37:14Z",
            "updated_at": "2015-01-22T20:37:14Z",
            "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
            "title": "",
            "alt": "",
            "position": 0
          },
          { 
            "id": 606,
            "created_at": "2015-01-22T20:37:15Z",
            "updated_at": "2015-01-22T20:37:15Z",
            "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
            "title": "",
            "alt": "",
            "position": 1
          },
          { 
            "id": 607,
            "created_at": "2015-01-22T20:37:15Z",
            "updated_at": "2015-01-22T20:37:15Z",
            "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
            "title": "",
            "alt": "",
            "position": 2
          },
          { 
            "id": 608,
            "created_at": "2015-01-22T20:37:16Z",
            "updated_at": "2015-01-22T20:37:16Z",
            "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
            "title": "",
            "alt": "",
            "position": 3
          }
        ],
        "featured_src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
        "attributes": [
          { 
            "name": "Color",
            "slug": "color",
            "position": 0,
            "visible": false,
            "variation": true,
            "options": [
              "Black",
              "Green"
            ]
          }
        ],
        "downloads": [],
        "download_limit": 0,
        "download_expiry": 0,
        "download_type": "",
        "purchase_note": "",
        "total_sales": 0,
        "variations": [
          { 
            "id": 609,
            "created_at": "2015-01-22T20:37:14Z",
            "updated_at": "2015-01-22T20:37:14Z",
            "downloadable": false,
            "virtual": false,
            "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=black",
            "sku": "",
            "price": "19.99",
            "regular_price": "19.99",
            "sale_price": null,
            "taxable": true,
            "tax_status": "taxable",
            "tax_class": "",
            "managing_stock": false,
            "stock_quantity": 0,
            "in_stock": true,
            "backordered": false,
            "purchaseable": true,
            "visible": true,
            "on_sale": false,
            "weight": null,
            "dimensions": { 
              "length": "",
              "width": "",
              "height": "",
              "unit": "cm"
            },
            "shipping_class": "",
            "shipping_class_id": null,
            "image": [
              { 
                "id": 610,
                "created_at": "2015-01-22T20:37:18Z",
                "updated_at": "2015-01-22T20:37:18Z",
                "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
                "title": "",
                "alt": "",
                "position": 0
              }
            ],
            "attributes": [
              { 
                "name": "Color",
                "slug": "color",
                "option": "black"
              }
            ],
            "downloads": [],
            "download_limit": 0,
            "download_expiry": 0
          },
          { 
            "id": 611,
            "created_at": "2015-01-22T20:37:14Z",
            "updated_at": "2015-01-22T20:37:14Z",
            "downloadable": false,
            "virtual": false,
            "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=green",
            "sku": "",
            "price": "19.99",
            "regular_price": "19.99",
            "sale_price": null,
            "taxable": true,
            "tax_status": "taxable",
            "tax_class": "",
            "managing_stock": false,
            "stock_quantity": 0,
            "in_stock": true,
            "backordered": false,
            "purchaseable": true,
            "visible": true,
            "on_sale": false,
            "weight": null,
            "dimensions": { 
              "length": "",
              "width": "",
              "height": "",
              "unit": "cm"
            },
            "shipping_class": "",
            "shipping_class_id": null,
            "image": [
              { 
                "id": 612,
                "created_at": "2015-01-22T20:37:19Z",
                "updated_at": "2015-01-22T20:37:19Z",
                "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
                "title": "",
                "alt": "",
                "position": 0
              }
            ],
            "attributes": [
              { 
                "name": "Color",
                "slug": "color",
                "option": "green"
              }
            ],
            "downloads": [],
            "download_limit": 0,
            "download_expiry": 0
          }
        ],
        "parent": []
      }
    }

## View A Product ##

This API lets you retrieve and view a specific product by ID.

### HTTP Request ###

*GET*

###### /wc-api/v3/products/<id> ######

curl https://example.com/wc-api/v3/products/546 \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/546', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/546").json())

woocommerce.get("products/546").parsed_response

> JSON response example:

## View List Of Products ##

This API helps you to view all the products.

### HTTP Request ###

*GET*

###### /wc-api/v3/products ######

curl https://example.com/wc-api/v3/products \
    	-u consumer_key:consumer_secret

WooCommerce.get('products', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products").json())

woocommerce.get("products").parsed_response

> JSON response example:

{ 
      "products": [
        { 
          "title": "Premium Quality",
          "id": 546,
          "created_at": "2015-01-22T19:46:16Z",
          "updated_at": "2015-01-22T19:46:16Z",
          "type": "simple",
          "status": "publish",
          "downloadable": false,
          "virtual": false,
          "permalink": "https://example.com/product/premium-quality/",
          "sku": "",
          "price": "21.99",
          "regular_price": "21.99",
          "sale_price": null,
          "price_html": "<span class=\"amount\">$ 21.99</span>",
          "taxable": true,
          "tax_status": "taxable",
          "tax_class": "",
          "managing_stock": false,
          "stock_quantity": 0,
          "in_stock": true,
          "backorders_allowed": false,
          "backordered": false,
          "sold_individually": false,
          "purchaseable": true,
          "featured": false,
          "visible": true,
          "catalog_visibility": "visible",
          "on_sale": false,
          "weight": null,
          "dimensions": { 
            "length": "",
            "width": "",
            "height": "",
            "unit": "cm"
          },
          "shipping_required": true,
          "shipping_taxable": true,
          "shipping_class": "",
          "shipping_class_id": null,
          "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
          "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
          "reviews_allowed": true,
          "average_rating": "0.00",
          "rating_count": 0,
          "related_ids": [
            37,
            47,
            31,
            19,
            22
          ],
          "upsell_ids": [],
          "cross_sell_ids": [],
          "parent_id": 0,
          "categories": [
            "Clothing",
            "T-shirts"
          ],
          "tags": [],
          "images": [
            { 
              "id": 547,
              "created_at": "2015-01-22T19:46:16Z",
              "updated_at": "2015-01-22T19:46:16Z",
              "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
              "title": "",
              "alt": "",
              "position": 0
            },
            { 
              "id": 548,
              "created_at": "2015-01-22T19:46:17Z",
              "updated_at": "2015-01-22T19:46:17Z",
              "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
              "title": "",
              "alt": "",
              "position": 1
            }
          ],
          "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
          "attributes": [],
          "downloads": [],
          "download_limit": 0,
          "download_expiry": 0,
          "download_type": "",
          "purchase_note": "",
          "total_sales": 0,
          "variations": [],
          "parent": []
        },
        { 
          "title": "Ship Your Idea",
          "id": 604,
          "created_at": "2015-01-22T20:37:14Z",
          "updated_at": "2015-01-22T20:37:14Z",
          "type": "variable",
          "status": "publish",
          "downloadable": false,
          "virtual": false,
          "permalink": "https://example/product/ship-your-idea/",
          "sku": "",
          "price": "19.99",
          "regular_price": "0.00",
          "sale_price": null,
          "price_html": "<span class=\"amount\">$ 19.99</span>",
          "taxable": true,
          "tax_status": "taxable",
          "tax_class": "",
          "managing_stock": false,
          "stock_quantity": 0,
          "in_stock": true,
          "backorders_allowed": false,
          "backordered": false,
          "sold_individually": false,
          "purchaseable": true,
          "featured": false,
          "visible": true,
          "catalog_visibility": "visible",
          "on_sale": false,
          "weight": null,
          "dimensions": { 
            "length": "",
            "width": "",
            "height": "",
            "unit": "cm"
          },
          "shipping_required": true,
          "shipping_taxable": true,
          "shipping_class": "",
          "shipping_class_id": null,
          "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
          "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
          "reviews_allowed": true,
          "average_rating": "0.00",
          "rating_count": 0,
          "related_ids": [
            40,
            37,
            47,
            577,
            34
          ],
          "upsell_ids": [],
          "cross_sell_ids": [],
          "parent_id": 0,
          "categories": [
            "Clothing",
            "T-shirts"
          ],
          "tags": [],
          "images": [
            { 
              "id": 605,
              "created_at": "2015-01-22T20:37:14Z",
              "updated_at": "2015-01-22T20:37:14Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
              "title": "",
              "alt": "",
              "position": 0
            },
            { 
              "id": 606,
              "created_at": "2015-01-22T20:37:15Z",
              "updated_at": "2015-01-22T20:37:15Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
              "title": "",
              "alt": "",
              "position": 1
            },
            { 
              "id": 607,
              "created_at": "2015-01-22T20:37:15Z",
              "updated_at": "2015-01-22T20:37:15Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
              "title": "",
              "alt": "",
              "position": 2
            },
            { 
              "id": 608,
              "created_at": "2015-01-22T20:37:16Z",
              "updated_at": "2015-01-22T20:37:16Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
              "title": "",
              "alt": "",
              "position": 3
            }
          ],
          "featured_src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
          "attributes": [
            { 
              "name": "Color",
              "slug": "color",
              "position": 0,
              "visible": false,
              "variation": true,
              "options": [
                "Black",
                "Green"
              ]
            }
          ],
          "downloads": [],
          "download_limit": 0,
          "download_expiry": 0,
          "download_type": "",
          "purchase_note": "",
          "total_sales": 0,
          "variations": [
            { 
              "id": 609,
              "created_at": "2015-01-22T20:37:14Z",
              "updated_at": "2015-01-22T20:37:14Z",
              "downloadable": false,
              "virtual": false,
              "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=black",
              "sku": "",
              "price": "19.99",
              "regular_price": "19.99",
              "sale_price": null,
              "taxable": true,
              "tax_status": "taxable",
              "tax_class": "",
              "managing_stock": false,
              "stock_quantity": 0,
              "in_stock": true,
              "backordered": false,
              "purchaseable": true,
              "visible": true,
              "on_sale": false,
              "weight": null,
              "dimensions": { 
                "length": "",
                "width": "",
                "height": "",
                "unit": "cm"
              },
              "shipping_class": "",
              "shipping_class_id": null,
              "image": [
                { 
                  "id": 610,
                  "created_at": "2015-01-22T20:37:18Z",
                  "updated_at": "2015-01-22T20:37:18Z",
                  "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
                  "title": "",
                  "alt": "",
                  "position": 0
                }
              ],
              "attributes": [
                { 
                  "name": "Color",
                  "slug": "color",
                  "option": "black"
                }
              ],
              "downloads": [],
              "download_limit": 0,
              "download_expiry": 0
            },
            { 
              "id": 611,
              "created_at": "2015-01-22T20:37:14Z",
              "updated_at": "2015-01-22T20:37:14Z",
              "downloadable": false,
              "virtual": false,
              "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=green",
              "sku": "",
              "price": "19.99",
              "regular_price": "19.99",
              "sale_price": null,
              "taxable": true,
              "tax_status": "taxable",
              "tax_class": "",
              "managing_stock": false,
              "stock_quantity": 0,
              "in_stock": true,
              "backordered": false,
              "purchaseable": true,
              "visible": true,
              "on_sale": false,
              "weight": null,
              "dimensions": { 
                "length": "",
                "width": "",
                "height": "",
                "unit": "cm"
              },
              "shipping_class": "",
              "shipping_class_id": null,
              "image": [
                { 
                  "id": 612,
                  "created_at": "2015-01-22T20:37:19Z",
                  "updated_at": "2015-01-22T20:37:19Z",
                  "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
                  "title": "",
                  "alt": "",
                  "position": 0
                }
              ],
              "attributes": [
                { 
                  "name": "Color",
                  "slug": "color",
                  "option": "green"
                }
              ],
              "downloads": [],
              "download_limit": 0,
              "download_expiry": 0
            }
          ],
          "parent": []
        }
      ]
    }

#### Available Filters ####

<table> 
 <thead> 
  <tr> 
   <th>Filter</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>type</code></td> 
   <td>string</td> 
   <td>Products by type. eg: <code>simple</code> or <code>variable</code></td> 
  </tr> 
  <tr> 
   <td><code>category</code></td> 
   <td>string</td> 
   <td>Products by category.</td> 
  </tr> 
  <tr> 
   <td><code>sku</code></td> 
   <td>string</td> 
   <td>Filter a product by SKU.</td> 
  </tr> 
 </tbody> 
</table>

## Update A Product ##

This API lets you make changes to a product.

### HTTP Request ###

*PUT*

###### /wc-api/v3/products/<id> ######

curl -X PUT https://example.com/wc-api/v3/products/546 \
    	-u consumer_key:consumer_secret \
    	-H "Content-Type: application/json" \
    	-d '{ "product": { "regular_price": "24.54" } }'

var data = { 
      product: { 
        regular_price: '24.54'
      }
    };
    
    WooCommerce.put('products/546', data, function(err, data, res) { 
      console.log(res);
    });

data = { 
        "product": { 
            "regular_price": "24.54"
        }
    }
    
    print(wcapi.put("products/546", data).json())

data = { 
      product: { 
        regular_price: "24.54"
      }
    }
    
    woocommerce.put("products/546", data).parsed_response

> JSON response example:

{ 
      "product": { 
        "title": "Premium Quality",
        "id": 546,
        "created_at": "2015-01-22T19:46:16Z",
        "updated_at": "2015-01-22T19:55:31Z",
        "type": "simple",
        "status": "publish",
        "downloadable": false,
        "virtual": false,
        "permalink": "https://example.com/product/premium-quality/",
        "sku": "",
        "price": "24.54",
        "regular_price": "24.54",
        "sale_price": null,
        "price_html": "<span class=\"amount\">$ 24.54</span>",
        "taxable": true,
        "tax_status": "taxable",
        "tax_class": "",
        "managing_stock": false,
        "stock_quantity": 0,
        "in_stock": true,
        "backorders_allowed": false,
        "backordered": false,
        "sold_individually": false,
        "purchaseable": true,
        "featured": false,
        "visible": true,
        "catalog_visibility": "visible",
        "on_sale": false,
        "weight": null,
        "dimensions": { 
          "length": "",
          "width": "",
          "height": "",
          "unit": "cm"
        },
        "shipping_required": true,
        "shipping_taxable": true,
        "shipping_class": "",
        "shipping_class_id": null,
        "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
        "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
        "reviews_allowed": true,
        "average_rating": "0.00",
        "rating_count": 0,
        "related_ids": [
          37,
          47,
          31,
          19,
          22
        ],
        "upsell_ids": [],
        "cross_sell_ids": [],
        "parent_id": 0,
        "categories": [
          "Clothing",
          "T-shirts"
        ],
        "tags": [],
        "images": [
          { 
            "id": 547,
            "created_at": "2015-01-22T19:46:16Z",
            "updated_at": "2015-01-22T19:46:16Z",
            "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
            "title": "",
            "alt": "",
            "position": 0
          },
          { 
            "id": 548,
            "created_at": "2015-01-22T19:46:17Z",
            "updated_at": "2015-01-22T19:46:17Z",
            "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
            "title": "",
            "alt": "",
            "position": 1
          }
        ],
        "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
        "attributes": [],
        "downloads": [],
        "download_limit": 0,
        "download_expiry": 0,
        "download_type": "",
        "purchase_note": "",
        "total_sales": 0,
        "variations": [],
        "parent": []
      }
    }

## Create/Update Multiple Products ##

This API helps you to bulk create/update multiple products.

To update is necessary to send objects containing IDs and to create new not just send the ID.

### HTTP Request ###

*POST*

###### /wc-api/v3/products/bulk ######

curl -X PUT https://example.com/wc-api/v3/products/bulk \
    	-u consumer_key:consumer_secret \
    	-H "Content-Type: application/json" \
    	-d '{ "products": [ { "id": 546, "regular_price": "29.99" }, { "id": 604, "variations": [ { "id": 609, "regular_price": "29.99" }, { "id": 611, "regular_price": "29.99" } ] } ] }'

data = { 
        "products": [
            { 
                "id": 546,
                "regular_price": "29.99"
            },
            { 
                "id": 604,
                "variations": [
                    { 
                        "id": 609,
                        "regular_price": "29.99"
                    },
                    { 
                        "id": 611,
                        "regular_price": "29.99"
                    }
                ]
            }
        ]
    }
    
    print(wcapi.put("products/bulk", data).json())

data = { 
      products: [
        { 
          id: 546,
          regular_price: "29.99"
        },
        { 
          id: 604,
          variations: [
            { 
              id: 609,
              regular_price: "29.99"
            },
            { 
              id: 611,
              regular_price: "29.99"
            }
          ]
        }
      ]
    }
    
    woocommerce.put("products/bulk", data).parsed_response

> JSON response example:

{ 
      "products": [
        { 
          "title": "Premium Quality",
          "id": 546,
          "created_at": "2015-01-22T19:46:16Z",
          "updated_at": "2015-07-27T14:22:32Z",
          "type": "simple",
          "status": "publish",
          "downloadable": false,
          "virtual": false,
          "permalink": "https://example.com/product/premium-quality/",
          "sku": "",
          "price": "29.99",
          "regular_price": "29.99",
          "sale_price": null,
          "price_html": "<span class=\"amount\">$ 29.99</span>",
          "taxable": true,
          "tax_status": "taxable",
          "tax_class": "",
          "managing_stock": false,
          "stock_quantity": 0,
          "in_stock": true,
          "backorders_allowed": false,
          "backordered": false,
          "sold_individually": false,
          "purchaseable": true,
          "featured": false,
          "visible": true,
          "catalog_visibility": "visible",
          "on_sale": false,
          "weight": null,
          "dimensions": { 
            "length": "",
            "width": "",
            "height": "",
            "unit": "cm"
          },
          "shipping_required": true,
          "shipping_taxable": true,
          "shipping_class": "",
          "shipping_class_id": null,
          "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
          "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
          "reviews_allowed": true,
          "average_rating": "0.00",
          "rating_count": 0,
          "related_ids": [
            37,
            47,
            31,
            19,
            22
          ],
          "upsell_ids": [],
          "cross_sell_ids": [],
          "parent_id": 0,
          "categories": [
            "Clothing",
            "T-shirts"
          ],
          "tags": [],
          "images": [
            { 
              "id": 547,
              "created_at": "2015-01-22T19:46:16Z",
              "updated_at": "2015-01-22T19:46:16Z",
              "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
              "title": "",
              "alt": "",
              "position": 0
            },
            { 
              "id": 548,
              "created_at": "2015-01-22T19:46:17Z",
              "updated_at": "2015-01-22T19:46:17Z",
              "src": "http://example.com/wp-content/uploads/2015/01/premium-quality-back.jpg",
              "title": "",
              "alt": "",
              "position": 1
            }
          ],
          "featured_src": "http://example.com/wp-content/uploads/2015/01/premium-quality-front.jpg",
          "attributes": [],
          "downloads": [],
          "download_limit": 0,
          "download_expiry": 0,
          "download_type": "",
          "purchase_note": "",
          "total_sales": 0,
          "variations": [],
          "parent": []
        },
        { 
          "title": "Ship Your Idea",
          "id": 604,
          "created_at": "2015-01-22T20:37:14Z",
          "updated_at": "2015-07-27T14:22:32Z",
          "type": "variable",
          "status": "publish",
          "downloadable": false,
          "virtual": false,
          "permalink": "https://example/product/ship-your-idea/",
          "sku": "",
          "price": "29.99",
          "regular_price": "0.00",
          "sale_price": null,
          "price_html": "<span class=\"amount\">$ 29.99</span>",
          "taxable": true,
          "tax_status": "taxable",
          "tax_class": "",
          "managing_stock": false,
          "stock_quantity": 0,
          "in_stock": true,
          "backorders_allowed": false,
          "backordered": false,
          "sold_individually": false,
          "purchaseable": true,
          "featured": false,
          "visible": true,
          "catalog_visibility": "visible",
          "on_sale": false,
          "weight": null,
          "dimensions": { 
            "length": "",
            "width": "",
            "height": "",
            "unit": "cm"
          },
          "shipping_required": true,
          "shipping_taxable": true,
          "shipping_class": "",
          "shipping_class_id": null,
          "description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.</p>\n",
          "short_description": "<p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.</p>\n",
          "reviews_allowed": true,
          "average_rating": "0.00",
          "rating_count": 0,
          "related_ids": [
            40,
            37,
            47,
            577,
            34
          ],
          "upsell_ids": [],
          "cross_sell_ids": [],
          "parent_id": 0,
          "categories": [
            "Clothing",
            "T-shirts"
          ],
          "tags": [],
          "images": [
            { 
              "id": 605,
              "created_at": "2015-01-22T20:37:14Z",
              "updated_at": "2015-01-22T20:37:14Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
              "title": "",
              "alt": "",
              "position": 0
            },
            { 
              "id": 606,
              "created_at": "2015-01-22T20:37:15Z",
              "updated_at": "2015-01-22T20:37:15Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-back.jpg",
              "title": "",
              "alt": "",
              "position": 1
            },
            { 
              "id": 607,
              "created_at": "2015-01-22T20:37:15Z",
              "updated_at": "2015-01-22T20:37:15Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
              "title": "",
              "alt": "",
              "position": 2
            },
            { 
              "id": 608,
              "created_at": "2015-01-22T20:37:16Z",
              "updated_at": "2015-01-22T20:37:16Z",
              "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-back.jpg",
              "title": "",
              "alt": "",
              "position": 3
            }
          ],
          "featured_src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
          "attributes": [
            { 
              "name": "Color",
              "slug": "color",
              "position": 0,
              "visible": false,
              "variation": true,
              "options": [
                "Black",
                "Green"
              ]
            }
          ],
          "downloads": [],
          "download_limit": 0,
          "download_expiry": 0,
          "download_type": "",
          "purchase_note": "",
          "total_sales": 0,
          "variations": [
            { 
              "id": 609,
              "created_at": "2015-01-22T20:37:14Z",
              "updated_at": "2015-07-27T14:22:32Z",
              "downloadable": false,
              "virtual": false,
              "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=black",
              "sku": "",
              "price": "29.99",
              "regular_price": "29.99",
              "sale_price": null,
              "taxable": true,
              "tax_status": "taxable",
              "tax_class": "",
              "managing_stock": false,
              "stock_quantity": 0,
              "in_stock": true,
              "backordered": false,
              "purchaseable": true,
              "visible": true,
              "on_sale": false,
              "weight": null,
              "dimensions": { 
                "length": "",
                "width": "",
                "height": "",
                "unit": "cm"
              },
              "shipping_class": "",
              "shipping_class_id": null,
              "image": [
                { 
                  "id": 610,
                  "created_at": "2015-01-22T20:37:18Z",
                  "updated_at": "2015-07-27T14:22:32Z",
                  "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-black-front.jpg",
                  "title": "",
                  "alt": "",
                  "position": 0
                }
              ],
              "attributes": [
                { 
                  "name": "Color",
                  "slug": "color",
                  "option": "black"
                }
              ],
              "downloads": [],
              "download_limit": 0,
              "download_expiry": 0
            },
            { 
              "id": 611,
              "created_at": "2015-01-22T20:37:14Z",
              "updated_at": "2015-07-27T14:22:32Z",
              "downloadable": false,
              "virtual": false,
              "permalink": "https://example/product/ship-your-idea-10/?attribute_pa_color=green",
              "sku": "",
              "price": "29.99",
              "regular_price": "29.99",
              "sale_price": null,
              "taxable": true,
              "tax_status": "taxable",
              "tax_class": "",
              "managing_stock": false,
              "stock_quantity": 0,
              "in_stock": true,
              "backordered": false,
              "purchaseable": true,
              "visible": true,
              "on_sale": false,
              "weight": null,
              "dimensions": { 
                "length": "",
                "width": "",
                "height": "",
                "unit": "cm"
              },
              "shipping_class": "",
              "shipping_class_id": null,
              "image": [
                { 
                  "id": 612,
                  "created_at": "2015-01-22T20:37:19Z",
                  "updated_at": "2015-01-22T20:37:19Z",
                  "src": "http://example/wp-content/uploads/2015/01/ship-your-idea-green-front.jpg",
                  "title": "",
                  "alt": "",
                  "position": 0
                }
              ],
              "attributes": [
                { 
                  "name": "Color",
                  "slug": "color",
                  "option": "green"
                }
              ],
              "downloads": [],
              "download_limit": 0,
              "download_expiry": 0
            }
          ],
          "parent": []
        }
      ]
    }

## Delete A Product ##

This API helps you delete a product.

### HTTP Request ###

*DELETE*

###### /wc-api/v3/products/<id> ######

curl -X DELETE https://example.com/wc-api/v3/products/546?force=true \
    	-u consumer_key:consumer_secret

WooCommerce.delete('products/546?force=true', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.delete("products/546?force=true").json())

woocommerce.delete("products/546?force=true").parsed_response

> JSON response example:

{ 
      "message": "Permanently deleted product"
    }

### Parameters ###

<table> 
 <thead> 
  <tr> 
   <th>Parameter</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>force</code></td> 
   <td>string</td> 
   <td>Use <code>true</code> whether to permanently delete the product, defaults to <code>false</code>. Note that permanently deleting the product will return HTTP 200 rather than HTTP 202.</td> 
  </tr> 
 </tbody> 
</table>

## View Products Count ##

This API lets you retrieve a count of all products.

### HTTP Request ###

*GET*

###### /wc-api/v3/products/count ######

curl https://example.com/wc-api/v3/products/count \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/count', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/count").json())

woocommerce.get("products/count").parsed_response

> JSON response example:

{ 
      "count": 2
    }

#### Available Filters ####

## Create A Product Attribute ##

This API helps you to create a new product attribute.

### HTTP Request ###

*POST*

###### /wc-api/v3/products/attributes ######

curl -X POST https://example.com/wc-api/v3/products/attributes \
        -u consumer_key:consumer_secret \
        -H "Content-Type: application/json" \
        -d '{ "product_attribute": { "name": "Color", "slug": "pa_color", "type": "select", "order_by": "menu_order", "has_archives": true } }'

data = { 
        "product_attribute": { 
            "name": "Color",
            "slug": "pa_color",
            "type": "select",
            "order_by": "menu_order",
            "has_archives": True
        }
    }
    
    print(wcapi.post("products/attributes", data).json())

data = { 
      product_attribute: { 
        name: "Color",
        slug: "pa_color",
        type: "select",
        order_by: "menu_order",
        has_archives: true
      }
    }
    
    woocommerce.post("products/attributes", data).parsed_response

> JSON response example:

{ 
      "product_attribute": { 
        "id": 1,
        "name": "Color",
        "slug": "pa_color",
        "type": "select",
        "order_by": "menu_order",
        "has_archives": true
      }
    }

### Product Attribute Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>id</code></td> 
   <td>integer</td> 
   <td>Attribute ID <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>name</code></td> 
   <td>string</td> 
   <td>Attribute name</td> 
  </tr> 
  <tr> 
   <td><code>slug</code></td> 
   <td>string</td> 
   <td>Attribute slug</td> 
  </tr> 
  <tr> 
   <td><code>type</code></td> 
   <td>string</td> 
   <td>Attribute type, the types available include by default are: <code>select</code> and <code>text</code> (some plugins can include new types)</td> 
  </tr> 
  <tr> 
   <td><code>order_by</code></td> 
   <td>string</td> 
   <td>Default sort order. Available: <code>menu_order</code>, <code>name</code>, <code>name_num</code> and <code>id</code></td> 
  </tr> 
  <tr> 
   <td><code>has_archives</code></td> 
   <td>boolean</td> 
   <td>Enable/Disable attribute archives</td> 
  </tr> 
 </tbody> 
</table>

## View A Product Attribute ##

This API lets you retrieve and view a specific product attribute by ID.

*GET*

###### /wc-api/v3/products/attributes/<id> ######

curl https://example.com/wc-api/v3/products/attributes/1 \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/attributes/1', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/attributes/1").json())

woocommerce.get("products/attributes/1").parsed_response

> JSON response example:

View the Product Attribute Properties for more details on this response.

## View List Of Product Attributes ##

This API helps you to view all the product attributes.

### HTTP Request ###

*GET*

###### /wc-api/v3/products/attributes ######

curl https://example.com/wc-api/v3/products/attributes \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/attributes', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/attributes").json())

woocommerce.get("products/attributes").parsed_response

> JSON response example:

{ 
      "product_attributes": [
        { 
          "id": 1,
          "name": "Color",
          "slug": "pa_color",
          "type": "select",
          "order_by": "menu_order",
          "has_archives": true
        },
        { 
          "id": 2,
          "name": "Size",
          "slug": "pa_size",
          "type": "select",
          "order_by": "menu_order",
          "has_archives": false
        }
      ]
    }

View the Product Attribute Properties for more details on this response.

## Update A Product Attribute ##

This API lets you make changes to a product attribute.

### HTTP Request ###

*PUT*

###### /wc-api/v3/products/attributes/<id> ######

curl -X PUT https://example.com/wc-api/v3/products/attributes/1 \
    	-u consumer_key:consumer_secret \
    	-H "Content-Type: application/json" \
    	-d '{ "product_attribute": { "order_by": "name" } }'

var data = { 
      product_attribute: { 
        order_by: 'name'
      }
    };
    
    WooCommerce.put('products/attributes/1', data, function(err, data, res) { 
      console.log(res);
    });

data = { 
        "product_attribute": { 
            "order_by": "name"
        }
    }
    
    print(wcapi.put("products/attributes/1", data).json())

data = { 
      product_attribute: { 
        order_by: "name"
      }
    }
    
    woocommerce.put("products/attributes/1", data).parsed_response

> JSON response example:

{ 
      "product_attribute": { 
        "id": 1,
        "name": "Color",
        "slug": "pa_color",
        "type": "select",
        "order_by": "name",
        "has_archives": true
      }
    }

View the Product Attribute Properties for more details on this response.

## Delete A Product Attribute ##

This API helps you delete a product attribute.

### HTTP Request ###

*DELETE*

###### /wc-api/v3/products/attributes/<id> ######

curl -X DELETE https://example.com/wc-api/v3/products/attributes/1 \
    	-u consumer_key:consumer_secret

WooCommerce.delete('products/attributes/1', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.delete("products/attributes/1").json())

woocommerce.delete("products/attributes/1").parsed_response

> JSON response example:

{ 
      "message": "Deleted product_attribute"
    }

## View A Product Category ##

This API lets you retrieve a product category.

*GET*

###### /wc-api/v3/products/categories/<id> ######

curl https://example.com/wc-api/v3/products/categories/9 \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/categories/9', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/categories/9").json())

woocommerce.get("products/categories/9").parsed_response

> JSON response example:

{ 
      "product_category": { 
        "id": 9,
        "name": "Clothing",
        "slug": "clothing",
        "parent": 0,
        "description": "",
        "display": "default",
        "image": "",
        "count": 23
      }
    }

### Product Category Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>id</code></td> 
   <td>integer</td> 
   <td>Category ID (term ID) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>name</code></td> 
   <td>string</td> 
   <td>Category name <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>slug</code></td> 
   <td>string</td> 
   <td>Category slug <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>parent</code></td> 
   <td>integer</td> 
   <td>Category parent <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>description</code></td> 
   <td>string</td> 
   <td>Category description <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>display</code></td> 
   <td>string</td> 
   <td>Category archive display type, the types available include: <code>default</code>, <code>products</code>, <code>subcategories</code> and <code>both</code> <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>image</code></td> 
   <td>string</td> 
   <td>Category image URL <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>count</code></td> 
   <td>boolean</td> 
   <td>Shows the quantity of products in this category <i>read-only</i></td> 
  </tr> 
 </tbody> 
</table>

## View List Of Product Categories ##

This API lets you retrieve all product categories.

*GET*

###### /wc-api/v3/products/categories ######

curl https://example.com/wc-api/v3/products/categories \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/categories', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/categories").json())

woocommerce.get("products/categories").parsed_response

> JSON response example:

{ 
      "product_categories": [
        { 
          "id": 15,
          "name": "Albums",
          "slug": "albums",
          "parent": 11,
          "description": "",
          "display": "default",
          "image": "",
          "count": 4
        },
        { 
          "id": 9,
          "name": "Clothing",
          "slug": "clothing",
          "parent": 0,
          "description": "",
          "display": "default",
          "image": "",
          "count": 23
        },
        { 
          "id": 10,
          "name": "Hoodies",
          "slug": "hoodies",
          "parent": 9,
          "description": "",
          "display": "default",
          "image": "",
          "count": 6
        },
        { 
          "id": 11,
          "name": "Music",
          "slug": "music",
          "parent": 0,
          "description": "",
          "display": "default",
          "image": "",
          "count": 6
        },
        { 
          "id": 12,
          "name": "Posters",
          "slug": "posters",
          "parent": 0,
          "description": "",
          "display": "default",
          "image": "",
          "count": 5
        },
        { 
          "id": 13,
          "name": "Singles",
          "slug": "singles",
          "parent": 11,
          "description": "",
          "display": "default",
          "image": "",
          "count": 2
        },
        { 
          "id": 14,
          "name": "T-shirts",
          "slug": "t-shirts",
          "parent": 9,
          "description": "",
          "display": "default",
          "image": "",
          "count": 17
        }
      ]
    }

View the Product Category Properties for more details on this response.

## View List Of Product Orders ##

This API lets you retrieve all product orders.

*GET*

###### /wc-api/v3/products/<id>/orders ######

curl https://example.com/wc-api/v3/products/546/orders \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/546/orders', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/546/orders").json())

woocommerce.get("products/546/orders").parsed_response

> JSON response example:

{ 
      "orders": [
        { 
          "id": 645,
          "order_number": 645,
          "created_at": "2015-01-26T20:00:21Z",
          "updated_at": "2015-07-31T11:45:12Z",
          "completed_at": "2015-01-26T20:00:21Z",
          "status": "processing",
          "currency": "USD",
          "total": "79.87",
          "subtotal": "63.97",
          "total_line_items_quantity": 3,
          "total_tax": "5.90",
          "total_shipping": "10.00",
          "cart_tax": "5.40",
          "shipping_tax": "0.50",
          "total_discount": "0.00",
          "shipping_methods": "Local Delivery",
          "payment_details": { 
            "method_id": "bacs",
            "method_title": "Direct Bank Transfer",
            "paid": true
          },
          "billing_address": { 
            "first_name": "John",
            "last_name": "Doe",
            "company": "",
            "address_1": "969 Market",
            "address_2": "",
            "city": "San Francisco",
            "state": "CA",
            "postcode": "94103",
            "country": "US",
            "email": "john.doe@example.com",
            "phone": "(555) 555-5555"
          },
          "shipping_address": { 
            "first_name": "John",
            "last_name": "Doe",
            "company": "",
            "address_1": "969 Market",
            "address_2": "",
            "city": "San Francisco",
            "state": "CA",
            "postcode": "94103",
            "country": "US"
          },
          "note": "",
          "customer_ip": "127.0.0.1",
          "customer_user_agent": "WordPress/4.1; http://example.com",
          "customer_id": 2,
          "view_order_url": "https://example.com/my-account/view-order/645",
          "line_items": [
            { 
              "id": 504,
              "subtotal": "43.98",
              "subtotal_tax": "4.40",
              "total": "43.98",
              "total_tax": "4.40",
              "price": "21.99",
              "quantity": 2,
              "tax_class": "reduced-rate",
              "name": "Premium Quality",
              "product_id": 546,
              "sku": "",
              "meta": []
            },
            { 
              "id": 505,
              "subtotal": "19.99",
              "subtotal_tax": "1.00",
              "total": "19.99",
              "total_tax": "1.00",
              "price": "19.99",
              "quantity": 1,
              "tax_class": null,
              "name": "Ship Your Idea",
              "product_id": 613,
              "sku": "",
              "meta": [
                { 
                  "key": "pa_color",
                  "label": "Color",
                  "value": "Black"
                }
              ]
            }
          ],
          "shipping_lines": [
            { 
              "id": 506,
              "method_id": "flat_rate",
              "method_title": "Local Delivery",
              "total": "10.00"
            }
          ],
          "tax_lines": [
            { 
              "id": 507,
              "rate_id": "5",
              "code": "US-CA-TAX-1",
              "title": "Tax",
              "total": "4.40",
              "compound": false
            },
            { 
              "id": 508,
              "rate_id": "4",
              "code": "US-STANDARD-1",
              "title": "Standard",
              "total": "1.50",
              "compound": false
            }
          ],
          "fee_lines": [],
          "coupon_lines": [],
          "customer": { 
            "id": 2,
            "created_at": "2014-11-19T18:34:19Z",
            "email": "john.doe@example.com",
            "first_name": "",
            "last_name": "",
            "username": "john.doe",
            "last_order_id": "645",
            "last_order_date": "2015-01-26T20:00:21Z",
            "orders_count": 2,
            "total_spent": "19.00",
            "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
            "billing_address": { 
              "first_name": "John",
              "last_name": "Doe",
              "company": "",
              "address_1": "969 Market",
              "address_2": "",
              "city": "San Francisco",
              "state": "CA",
              "postcode": "94103",
              "country": "US",
              "email": "john.doe@example.com",
              "phone": "(555) 555-5555"
            },
            "shipping_address": { 
              "first_name": "John",
              "last_name": "Doe",
              "company": "",
              "address_1": "969 Market",
              "address_2": "",
              "city": "San Francisco",
              "state": "CA",
              "postcode": "94103",
              "country": "US"
            }
          }
        },
        { 
          "id": 644,
          "order_number": 644,
          "created_at": "2015-01-26T19:33:42Z",
          "updated_at": "2015-07-31T11:45:12Z",
          "completed_at": "2015-01-26T19:33:42Z",
          "status": "on-hold",
          "currency": "USD",
          "total": "44.14",
          "subtotal": "30.99",
          "total_line_items_quantity": 2,
          "total_tax": "3.15",
          "total_shipping": "10.00",
          "cart_tax": "2.65",
          "shipping_tax": "0.50",
          "total_discount": "0.00",
          "shipping_methods": "Flat Rate",
          "payment_details": { 
            "method_id": "bacs",
            "method_title": "Direct Bank Transfer",
            "paid": false
          },
          "billing_address": { 
            "first_name": "John",
            "last_name": "Doe",
            "company": "",
            "address_1": "969 Market",
            "address_2": "",
            "city": "San Francisco",
            "state": "CA",
            "postcode": "94103",
            "country": "US",
            "email": "john.doe@example.com",
            "phone": "(555) 555-5555"
          },
          "shipping_address": { 
            "first_name": "John",
            "last_name": "Doe",
            "company": "",
            "address_1": "969 Market",
            "address_2": "",
            "city": "San Francisco",
            "state": "CA",
            "postcode": "94103",
            "country": "US"
          },
          "note": "",
          "customer_ip": "127.0.0.1",
          "customer_user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.91 Safari/537.36",
          "customer_id": 2,
          "view_order_url": "https://example.com/my-account/view-order/644",
          "line_items": [
            { 
              "id": 499,
              "subtotal": "21.99",
              "subtotal_tax": "2.20",
              "total": "21.99",
              "total_tax": "2.20",
              "price": "21.99",
              "quantity": 1,
              "tax_class": "reduced-rate",
              "name": "Premium Quality",
              "product_id": 546,
              "sku": "",
              "meta": []
            },
            { 
              "id": 500,
              "subtotal": "9.00",
              "subtotal_tax": "0.45",
              "total": "9.00",
              "total_tax": "0.45",
              "price": "9.00",
              "quantity": 1,
              "tax_class": null,
              "name": "Woo Album #4",
              "product_id": 96,
              "sku": "",
              "meta": []
            }
          ],
          "shipping_lines": [
            { 
              "id": 501,
              "method_id": "flat_rate",
              "method_title": "Flat Rate",
              "total": "10.00"
            }
          ],
          "tax_lines": [
            { 
              "id": 502,
              "rate_id": "5",
              "code": "US-CA-TAX-1",
              "title": "Tax",
              "total": "4.40",
              "compound": false
            },
            { 
              "id": 503,
              "rate_id": "4",
              "code": "US-STANDARD-1",
              "title": "Standard",
              "total": "1.50",
              "compound": false
            }
          ],
          "fee_lines": [],
          "coupon_lines": [],
          "customer": { 
            "id": 2,
            "created_at": "2014-11-19T18:34:19Z",
            "email": "john.doe@example.com",
            "first_name": "",
            "last_name": "",
            "username": "john.doe",
            "last_order_id": "645",
            "last_order_date": "2015-01-26T20:00:21Z",
            "orders_count": 2,
            "total_spent": "19.00",
            "avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
            "billing_address": { 
              "first_name": "John",
              "last_name": "Doe",
              "company": "",
              "address_1": "969 Market",
              "address_2": "",
              "city": "San Francisco",
              "state": "CA",
              "postcode": "94103",
              "country": "US",
              "email": "john.doe@example.com",
              "phone": "(555) 555-5555"
            },
            "shipping_address": { 
              "first_name": "John",
              "last_name": "Doe",
              "company": "",
              "address_1": "969 Market",
              "address_2": "",
              "city": "San Francisco",
              "state": "CA",
              "postcode": "94103",
              "country": "US"
            }
          }
        }
      ]
    }

View the Order Properties for more details on this response.

## View List Of Product Reviews ##

This API lets you retrieve all reviews of a product.

*GET*

###### /wc-api/v3/products/<id>/reviews ######

curl https://example.com/wc-api/v3/products/546/reviews \
    	-u consumer_key:consumer_secret

WooCommerce.get('products/546/reviews', function(err, data, res) { 
      console.log(res);
    });

print(wcapi.get("products/546/reviews").json())

woocommerce.get("products/546/reviews").parsed_response

> JSON response example:

{ 
      "product_reviews": [
        { 
          "id": 4,
          "created_at": "2013-06-07T11:57:45Z",
          "review": "This t-shirt is awesome! Would recommend to everyone!\n\nI'm ordering mine next week",
          "rating": "5",
          "reviewer_name": "Andrew",
          "reviewer_email": "andrew@example.com",
          "verified": false
        },
        { 
          "id": 3,
          "created_at": "2013-06-07T11:53:49Z",
          "review": "Wonderful quality, and an awesome design. WooThemes ftw!",
          "rating": "4",
          "reviewer_name": "Cobus Bester",
          "reviewer_email": "cobus@example.com",
          "verified": false
        }
      ]
    }

### Product Reviews Properties ###

<table> 
 <thead> 
  <tr> 
   <th>Attribute</th> 
   <th>Type</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>id</code></td> 
   <td>integer</td> 
   <td>Review ID (comment ID) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>created_at</code></td> 
   <td>string</td> 
   <td>UTC DateTime when the review was created <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>rating</code></td> 
   <td>string</td> 
   <td>Review rating (0 to 5) <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>reviewer_name</code></td> 
   <td>string</td> 
   <td>Reviewer name <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>reviewer_email</code></td> 
   <td>string</td> 
   <td>Reviewer email <i>read-only</i></td> 
  </tr> 
  <tr> 
   <td><code>verified</code></td> 
   <td>boolean</td> 
   <td>Shows if the reviewer bought the product or not <i>read-only</i></td> 
  </tr> 
 </tbody> 
</table>