Skip to main content
GET
/
api
/
productos
/
precio
Get Products by Price Range
curl --request GET \
  --url https://api.example.com/api/productos/precio
{
  "200": {},
  "400": {},
  "productos": [
    {
      "producto_id": 123,
      "sku": "<string>",
      "nombre": "<string>",
      "descripcion": "<string>",
      "precioCantidad": 123,
      "precioMoneda": "<string>",
      "dimensionesAlto": 123,
      "dimensionesAncho": 123,
      "dimensionesProfundo": 123,
      "es_destacado": true,
      "stock": 123,
      "imagen_url": "<string>",
      "categoria": {}
    }
  ]
}

​
Authentication

This endpoint is publicly accessible and does not require authentication.

​
Query Parameters

​
min
number
required
Minimum price (inclusive). Must be a positive decimal number.
​
max
number
required
Maximum price (inclusive). Must be greater than or equal to the minimum price.

​
Response

Returns an array of product objects that fall within the specified price range.
​
productos
array
Array of product objects matching the price criteria

​
Example Requests

curl -X GET "http://localhost:8080/api/productos/precio?min=0&max=500"
JavaScript
// Filter products between 200 and 800 EUR
const min = 200;
const max = 800;
const response = await fetch(
  `http://localhost:8080/api/productos/precio?min=${min}&max=${max}`
);
const products = await response.json();
console.log(`Found ${products.length} products in price range`);
Python
import requests

# Get products between 300 and 1000 EUR
params = {
    'min': 300,
    'max': 1000
}
response = requests.get(
    'http://localhost:8080/api/productos/precio',
    params=params
)
products = response.json()
print(f'Found {len(products)} products')

​
Example Response

[
  {
    "producto_id": 1,
    "sku": "SOFA-001",
    "nombre": "Sofá Klippan 2 plazas",
    "descripcion": "Sofá compacto y versátil con funda lavable",
    "precioCantidad": 299.00,
    "precioMoneda": "EUR",
    "dimensionesAlto": 66,
    "dimensionesAncho": 180,
    "dimensionesProfundo": 88,
    "es_destacado": true,
    "stock": 12,
    "imagen_url": "https://example.com/sofa-klippan.jpg",
    "categoria": {
      "categoria_id": 1,
      "nombre": "Salón",
      "slug": "salon"
    }
  },
  {
    "producto_id": 5,
    "sku": "MESA-003",
    "nombre": "Mesa de centro Lack",
    "descripcion": "Mesa de centro moderna con acabado blanco",
    "precioCantidad": 49.99,
    "precioMoneda": "EUR",
    "dimensionesAlto": 45,
    "dimensionesAncho": 90,
    "dimensionesProfundo": 55,
    "es_destacado": false,
    "stock": 28,
    "imagen_url": "https://example.com/mesa-lack.jpg",
    "categoria": {
      "categoria_id": 3,
      "nombre": "Mesas",
      "slug": "mesas"
    }
  }
]

​
Status Codes

​
200
OK
Products retrieved successfully. Returns an empty array if no products match the criteria.
​
400
Bad Request
Invalid parameters (e.g., min > max, negative values, missing parameters)

​
Use Cases

  • Price filtering: Allow customers to filter products by budget
  • Sales and promotions: Find products in specific price tiers
  • Comparison shopping: Show products within a customer’s price range
  • Inventory analysis: Identify products in different price segments
Combine this endpoint with other filters (category, search) on the frontend to create a comprehensive product filtering experience.
The price comparison uses the precioCantidad field. All products are assumed to be in the same currency for comparison purposes.

Build docs developers (and LLMs) love

Get started for freeTalk to us