# WooCommerce stores · Search products

Get product, price and seller data with WooCommerce stores · Search products from Alexandria through one Spiral API key. Product catalogue, prices or stock from a store running WooCommerce (WordPress shops on their own domain). Start here; get ids or slugs for get_product, category slugs from list_categories, attribute taxonomies and term slugs from list_attributes. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: E-commerce
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `woocommerce-com/products/search_products`
- Page: https://spiral.ai/tools/alexandria/woocommerce-com/products/search_products

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `store` (required) | text |  | — | The store: a bare domain (example.com) or any URL on the store. Any WooCommerce site with the public Store API (/wp-json/wc/store/v1) enabled. |
| `tag` | text |  | — | One product tag id or slug. Pattern: ^[^,\s]+$. |
| `page` | number | 1 to 10000 | 1 | 1-based page; use next_page from the previous result. |
| `order` | one of | asc, desc | — | order |
| `query` | text |  | — | Keywords matched against product title and content. |
| `on_sale` | true or false |  | — | Only products on sale. |
| `orderby` | one of | date, modified, id, title, slug, price, popularity, rating, menu_order | — | Sort key; the store's default (relevance for a query, else date) otherwise. |
| `category` | text |  | — | One category id or slug (from list_categories); includes subcategories as the store does. Pattern: ^[^,\s]+$. |
| `featured` | true or false |  | — | Only featured products. |
| `per_page` | number | 1 to 100 | 20 | per_page |
| `max_price` | number | 0 to … | — | Maximum price in major units of the store currency. |
| `min_price` | number | 0 to … | — | Minimum price in major units of the store currency (e.g. 19.99). |
| `attributes` | JSON |  | — | Attribute term filters (all must match). |
| `stock_status` | list |  | — | stock_status |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "woocommerce-com/products/search_products",
    "input": {
      "store": "<store>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=woocommerce-com%2Fproducts%2Fsearch_products

## Common questions

### WooCommerce stores · Search products

**How much does WooCommerce stores · Search products cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use WooCommerce stores · Search products through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "woocommerce-com/products/search_products"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use WooCommerce stores · Search products?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use WooCommerce stores · Search products?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

