# WooCommerce REST API

**Provider:** Automattic
**Category:** ecommerce
**Base URL:** `https://{your-domain}/wp-json/wc/v3`
**Auth:** basic — `Authorization: Basic base64(ck_...:cs_...)`
**Rate Limit:** Depends on your hosting (typically no built-in API limit)
**Free Tier:** Yes — [object Object]
**Pricing:** Free (free)
**Docs:** https://woocommerce.github.io/woocommerce-rest-api-docs/

## Description

The WooCommerce REST API lets you read and write data from any WordPress/WooCommerce store. Create and update products, process orders and refunds, manage customer accounts, apply coupons, configure shipping zones and tax rates, and pull sales reports. Supports both OAuth 1.0a and API key authentication. Ideal for building custom integrations, ERP sync, and headless WooCommerce storefronts.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://{your-domain}/wp-json/wc/v3/products` | List products with filtering and pagination |
| POST | `https://{your-domain}/wp-json/wc/v3/products` | Create a new product with attributes |
| GET | `https://{your-domain}/wp-json/wc/v3/orders` | List orders by status, date, or customer |
| PUT | `https://{your-domain}/wp-json/wc/v3/orders/{id}` | Update order status or add notes |
| GET | `https://{your-domain}/wp-json/wc/v3/customers` | List customers with billing/shipping info |
| GET | `https://{your-domain}/wp-json/wc/v3/reports/sales` | Get sales totals for a date range |

## Authentication

Generate Consumer Key and Consumer Secret in WooCommerce Settings → Advanced → REST API. Use HTTP Basic Auth (key:secret, base64-encoded) or pass as query parameters.

```
Authorization: Basic base64(ck_...:cs_...)
```

## Sample Request

```bash
curl "https://mystore.com/wp-json/wc/v3/products?status=publish&per_page=5" \
  -u "$WC_CONSUMER_KEY:$WC_CONSUMER_SECRET"
```

## Sample Response

```json
{
  "id": 93,
  "name": "Premium Quality",
  "status": "publish",
  "price": "21.99",
  "stock_quantity": 85,
  "categories": [{"id": 9, "name": "Clothing"}],
  "images": [{"src": "https://mystore.com/wp-content/uploads/product.jpg"}]
}
```

## Pricing Details

WooCommerce is free and open-source. Add-ons are priced separately (e.g., WooCommerce Payments: 2.9% + $0.30/transaction). Hosting from $5/mo.

---

*Source: [API Map](https://apimap.dev/apis/woocommerce/) — CC BY 4.0*