Tiendanube / Nuvemshop stores · List products
tiendanube-com/products/list_productsGet product, price and seller data with Tiendanube / Nuvemshop stores · List products from Alexandria through one Spiral API key. Catalogue, new products (sort created-descending), prices or stock of a store on Tiendanube / Nuvemshop (*.mitiendanube.com, *.lojavirtualnuvem.com.br or a custom domain). Get category paths from list_categories and product details from get_product. 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 (tienda.example.com, example.mitiendanube.com, example.lojavirtualnuvem.com.br) or any URL on it. Any Tiendanube / Nuvemshop storefront, including custom domains. |
page | number 1 to 500 | — | Page number (default 1); the page size is the store theme's. |
sort | one of user, price-ascending, price-descending, alpha-ascending, alpha-descending, created-ascending, created-descending, best-selling | — | Storefront sort order; omit for the store's default. created-descending lists the newest products first; user is the store's featured order. |
query | text | — | Keywords matched (accent-insensitive, every word) against product URL slugs from the store's sitemap. Cannot be combined with category or sort. |
category | text | — | One category: its path (/ropa/remeras/) or its URL on the store, from list_categories. Omit for the all-products listing. |
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": "tiendanube-com/products/list_products",
"input": {
"store": "<store>"
}
}'Frequently asked questions
How much does Tiendanube / Nuvemshop stores · List 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 Tiendanube / Nuvemshop stores · List products through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "tiendanube-com/products/list_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 Tiendanube / Nuvemshop stores · List products?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use Tiendanube / Nuvemshop stores · List products?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.