BigCommerce – Cómo detectar productos sin categoría o sin imágenes mediante la API

Introducción

En tiendas grandes en BigCommerce, es habitual tener productos huérfanos: sin categoría asignada o sin imágenes. Esto afecta el SEO, la experiencia de usuario y puede generar productos invisibles en el catálogo.

En este artículo aprenderás cómo detectar productos sin categoría o sin imágenes usando la API de BigCommerce, con ejemplos de llamadas API y tips prácticos.

Índice

• 1. Por qué buscar productos huérfanos
• 2. Conexión a la API de BigCommerce
• 3. Detectar productos sin categoría
• 4. Detectar productos sin imágenes
• 5. Buenas prácticas y SEO
• 6. Conclusión

1. Por qué buscar productos huérfanos

• ⚠️ Productos sin categoría no aparecen en la navegación ni en búsquedas.
• 🖼️ Productos sin imagen reducen la confianza del cliente.
• 📉 Puede afectar el SEO y generar errores de rastreo.

2. Conexión a la API de BigCommerce

Para acceder a la API necesitas:

• 🔑 Client ID
• 🔐 Access Token
• 🌐 Store Hash

Ejemplo de conexión básica con PHP:

<?php
$store_hash = 'tu_store_hash';
$token = 'tu_token';

$url = "https://api.bigcommerce.com/stores/$store_hash/v3/catalog/products";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-Auth-Token: $token",
  "Accept: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>

3. Detectar productos sin categoría

Usa el endpoint /v3/catalog/products. Cada producto tiene un array categories:

foreach ($data['data'] as $product) {
  if (empty($product['categories'])) {
    echo "Producto sin categoría: " . $product['name'] . "\n";
  }
}

Esto te listará productos huérfanos sin ninguna categoría asignada.

4. Detectar productos sin imágenes

Para detectar productos sin imágenes, consulta /v3/catalog/products/{product_id}/images:

$product_id = 123;
$url_img = "https://api.bigcommerce.com/stores/$store_hash/v3/catalog/products/$product_id/images";

$ch = curl_init($url_img);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-Auth-Token: $token",
  "Accept: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$images = json_decode($response, true);

if (empty($images['data'])) {
  echo "Producto sin imágenes: ID $product_id\n";
}

✅ Esto detecta si el producto no tiene imágenes asignadas.

5. Buenas prácticas y SEO

• 🔎 Revisa estos datos regularmente para mantener el catálogo limpio.
• 📈 Completa siempre títulos, descripciones y categorías para SEO.
• 🖼️ Usa imágenes optimizadas y con atributo alt para accesibilidad.

6. Conclusión

La API de BigCommerce permite mantener tu catálogo optimizado y libre de productos huérfanos. Esto mejora el SEO y la experiencia de compra de tus clientes.

📩 ¿Quieres integrar esta verificación de forma automática? ¡Contáctanos!