pinterest-scraper-api

v1.0.0

Published

5 months ago

Un scraper de Pinterest que utiliza la API de pinscrapper.vercel.app para buscar imágenes y extraer enlaces directos.

Downloads

0High
0Medium
0Low

ondarion

pinterest scraper api images

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

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);
    });
  });
}

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;
}

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 [];
  }
}