Tiendanube - Get Products

Description

This module allows querying products from a Tiendanube store. It can get a specific product by ID or list products with various filters such as category, publication status, dates, and more.

Configuration

Required Credentials

• Store ID: Your store ID (visible in the panel URL)
• Access Token: OAuth2 access token

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Tiendanube credentials
product_id	string	No	Specific product ID
category_id	string	No	Filter by category
published	select	No	Publication status
free_shipping	select	No	With/without free shipping
created_at_min	string	No	Minimum creation date
created_at_max	string	No	Maximum creation date
sort_by	select	No	Sorting
per_page	number	No	Results per page (default: 50)
page	number	No	Page number (default: 1)

Output

{
  "success": true,
  "products": [...],
  "count": 50,
  "page": 1,
  "per_page": 50,
  "message": "50 products retrieved"
}

Product Fields

• id: Product ID
• name: Object with name by language (es, pt)
• description: Object with description by language
• handle: SEO-friendly URL by language
• variants: Variants array
• images: Images array
• categories: Categories array
• brand: Brand
• published: Publication status
• free_shipping: Free shipping
• created_at: Creation date
• updated_at: Update date

Usage Example

Get product by ID

{
  "product_id": "12345678"
}

Published products from a category

{
  "category_id": "123",
  "published": "true",
  "sort_by": "created_at-desc"
}

Products with free shipping

{
  "free_shipping": "true",
  "per_page": 100
}

API Used

• Endpoint: GET /v1/{store_id}/products
• Documentation: Tiendanube API

Notes

• Text fields (name, description) are multilingual objects
• The primary language depends on the store’s country (es for Latin America, pt for Brazil)
• Each product can have multiple variants with independent prices and stock
• The maximum limit per page is 200 products

Related Nodes

• TiendanubeCreateProduct - Create a new product
• TiendanubeUpdateProduct - Update product data
• TiendanubeGetOrders - Get orders that include products