Documentación de Feeds de Productos

Bienvenido a la referencia técnica de EcoMarket. Nuestra plataforma ofrece acceso abierto y en tiempo real a nuestro catálogo de productos para que desarrolladores, afiliados y dueños de tiendas puedan sincronizar inventarios fácilmente.

Estos feeds se generan directamente desde nuestra base de datos en vivo, asegurando que los precios y el stock estén siempre actualizados (Stock: "in stock" / "out of stock").

Autenticación y Acceso

EcoMarket promueve un ecosistema abierto. No necesitas una API Key ni un Token de acceso para leer los datos públicos de los productos.

Acceso 100% público (GET request).
Soporte CORS habilitado (Access-Control-Allow-Origin: *) para integraciones directas desde el navegador.
Cualquier sistema puede consumir estos datos: Wordpress, Shopify, Apps Móviles, Scripts personalizados.

Feed Estándar (XML / JSON)

v1.0

Este es el punto de entrada principal para desarrolladores. Permite obtener el catálogo completo con soporte para paginación y selección de formato. Ideal para sincronizaciones masivas.

GET https://feed.ecomarket.uno/

Parámetro	Tipo	Default	Descripción
format	string	`xml`	Formato de salida. Valores aceptados: `xml`, `json`.
page	integer	`1`	Número de página para paginación de resultados.
limit	integer	`100`	Cantidad de productos por llamada.

Ejemplo de Solicitud (JSON)

GET https://feed.ecomarket.uno/xml/?format=json&page=1&limit=5

Respuesta de Ejemplo

{
  "meta": {
    "total_products": 1540,
    "per_page": 5,
    "current_page": 1,
    "total_pages": 308,
    "generated_at": "2025-10-25T14:30:00-04:00"
  },
  "products": [
    {
      "id": 452,
      "title": "Tenis Deportivos Running",
      "description": "Tenis ligeros para correr...",
      "link": "https://ecomarket.uno/products/tenis-deportivos-run",
      "image_link": "https://ecomarket.uno/storage/products/img1.jpg",
      "availability": "in stock",
      "price": "2500.00 DOP",
      "sale_price": "2200.00 DOP",
      "brand": "Nike",
      "product_type": "Deportes > Calzado",
      "condition": "new"
    }
  ]
}

Feed para Facebook / Instagram (CSV)

Un feed optimizado específicamente para el Comercio de Meta (Catalog Manager). Este archivo CSV cumple con todos los estándares requeridos para crear anuncios dinámicos y tiendas en Instagram/Facebook.

GET https://feed.ecomarket.uno/xml/facebook.php

Descarga Inmediata

Al acceder a esta URL, el navegador iniciará automáticamente la descarga del archivo facebook_products_feed.csv.

Columnas Incluidas (CSV Header)

Columna	Ejemplo	Notas
id	104	ID único del producto
title	Reloj Inteligente	Nombre limpio
price	1500.00 DOP	Prioriza el precio de oferta si existe
availability	in stock	Basado en cantidad > 0
image_link	https://.../img.jpg	Enlace público a la imagen

Límites y Buenas Prácticas

Paginación Obligatoria

Para no saturar el servidor y garantizar una respuesta rápida, el Feed XML/JSON devuelve 100 productos por defecto por cada llamada.

Usa el parámetro ?page=2, ?page=3, etc., para recorrer todo el catálogo.

Imágenes

Todas las imágenes se sirven desde ecomarket.uno/storage/. Asegúrate de que tu sistema pueda descargar imágenes HTTPS.