pinterest-scraper-api

Pinterest Scraper API

Un paquete de Node.js potente para buscar imágenes en Pinterest

Extrae enlaces directos de imágenes utilizando la API de pinscrapper.vercel.app

Características Principales

Búsqueda Potente Encuentra cualquier imagen en Pinterest Soporte para búsquedas en español e inglés Filtros avanzados de resultados	Ultra Rápido Resultados en milisegundos Optimizado para rendimiento Cache inteligente incluido
Enlaces Directos URLs de imágenes listas para usar Sin redirects ni proxies Máxima calidad disponible	Metadata Completa Títulos y descripciones Dimensiones de imagen Información del autor

Instalación

# Usando npm
npm install pinterest-scraper-api

# Usando yarn
yarn add pinterest-scraper-api

# Usando pnpm
pnpm add pinterest-scraper-api

Uso

Importación

// CommonJS
const pinterestScraper = require('pinterest-scraper-api');

// ES Modules
import pinterestScraper from 'pinterest-scraper-api';

Búsqueda Básica

async function getPinterestImages() {
  try {
    const images = await pinterestScraper.searchPinterest('paisajes naturales', 10);
    console.log(`Encontradas ${images.length} imágenes`);
    console.log(images);
  } catch (error) {
    console.error('Error en la búsqueda:', error);
  }
}

getPinterestImages();

Búsqueda Avanzada

async function busquedaAvanzada() {
  const opciones = {
    query: 'arquitectura moderna',
    limit: 25,
    timeout: 10000
  };
  
  const resultados = await pinterestScraper.searchPinterest(opciones.query, opciones.limit);
  return resultados;
}

API Reference

searchPinterest(query, limit)

Busca imágenes en Pinterest y retorna sus enlaces directos.

Parámetros

Parámetro	Tipo	Descripción	Valor por defecto	Requerido
query	String	Término de búsqueda	-	✅ Si
limit	Number	Número máximo de resultados	20	❌ No

Valor de Retorno

Retorna una Promise que se resuelve con un array de objetos. Cada objeto contiene:

interface PinterestImage {
  id: string;          // ID único de la imagen
  title: string;       // Título de la imagen
  imageUrl: string;    // URL directo de la imagen
  originalUrl: string; // URL de Pinterest
  description: string; // Descripción de la imagen
  author: string;      // Nombre del autor
  width: number;       // Ancho en píxeles
  height: number;      // Alto en píxeles
}

Ejemplos

Ejemplo 1: Descarga de imágenes

const fs = require('fs');
const https = require('https');
const pinterestScraper = require('pinterest-scraper-api');

async function descargarImagenes() {
  const imagenes = await pinterestScraper.searchPinterest('naturaleza', 5);
  
  imagenes.forEach((imagen, index) => {
    const file = fs.createWriteStream(`imagen_${index + 1}.jpg`);
    https.get(imagen.imageUrl, (response) => {
      response.pipe(file);
    });
  });
}

Ejemplo 2: Filtrar por dimensiones

async function imagenesDimensiones() {
  const todasLasImagenes = await pinterestScraper.searchPinterest('wallpapers', 50);
  
  // Filtrar imágenes de alta resolución
  const imagenesHD = todasLasImagenes.filter(img => 
    img.width >= 1920 && img.height >= 1080
  );
  
  console.log(`Encontradas ${imagenesHD.length} imágenes HD`);
  return imagenesHD;
}

Ejemplo 3: Manejo de errores avanzado

async function busquedaSegura(termino) {
  try {
    const imagenes = await pinterestScraper.searchPinterest(termino, 15);
    
    if (imagenes.length === 0) {
      console.log('No se encontraron imágenes para:', termino);
      return [];
    }
    
    return imagenes;
  } catch (error) {
    if (error.code === 'ECONNREFUSED') {
      console.error('Error de conexión - intenta más tarde');
    } else if (error.code === 'ETIMEDOUT') {
      console.error('Tiempo de espera agotado');
    } else {
      console.error('Error desconocido:', error.message);
    }
    return [];
  }
}

Contribuir

Las contribuciones son bienvenidas. Para cambios importantes, abre primero un issue para discutir qué te gustaría cambiar.

• Fork el proyecto
• Crea tu rama de feature (git checkout -b feature/AmazingFeature)
• Commit tus cambios (git commit -m 'Add some AmazingFeature')
• Push a la rama (git push origin feature/AmazingFeature)
• Abre un Pull Request

Soporte

¿Tienes problemas? ¿Necesitas ayuda? Estamos aquí para ti:

• Reporta bugs en GitHub Issues
• Únete a nuestro Discord para chat en tiempo real
• Haz preguntas en Stack Overflow con el tag pinterest-scraper-api

Changelog

Consulta el CHANGELOG.md para ver todos los cambios de cada versión.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

¿Te gusta el proyecto? Dale una estrella ⭐

Hecho con ❤️ por Studio Corporation Crew