WooCommerce stores · Search products
woocommerce-com/products/search_productsGet 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.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- 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 | 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 |
Same request in code
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>"
}
}'Frequently asked questions
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.