Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaE-commerceAvailable now

WooCommerce stores · Search products

woocommerce-com/products/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.

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

FieldKindDefaultDescription
store requiredtext—

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.

tagtext—

One product tag id or slug. Pattern: ^[^,\s]+$.

pagenumber
1 to 10000
1

1-based page; use next_page from the previous result.

orderone of
asc, desc
—

order

querytext—

Keywords matched against product title and content.

on_saletrue or false—

Only products on sale.

orderbyone of
date, modified, id, title, slug, price, popularity, rating, menu_order
—

Sort key; the store's default (relevance for a query, else date) otherwise.

categorytext—

One category id or slug (from list_categories); includes subcategories as the store does. Pattern: ^[^,\s]+$.

featuredtrue or false—

Only featured products.

per_pagenumber
1 to 100
20

per_page

max_pricenumber
0 to …
—

Maximum price in major units of the store currency.

min_pricenumber
0 to …
—

Minimum price in major units of the store currency (e.g. 19.99).

attributesJSON—

Attribute term filters (all must match).

stock_statuslist—

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.