> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Scraping de Etsy

> Extrae productos artesanales, datos de tiendas y precios del marketplace de Etsy

<Info>
  Etsy es un marketplace global de artículos únicos y creativos. Esta guía te muestra cómo extraer fichas de productos, información de tiendas, reseñas y artículos en tendencia con Firecrawl.
</Info>

<div id="setup">
  ## Configuración
</div>

```bash theme={null}
npm install firecrawl zod
```

<div id="overview">
  ## Descripción general
</div>

Al hacer scraping en Etsy, normalmente querrás:

* Extraer listados de productos y variantes
* Obtener información y valoraciones de las tiendas
* Supervisar artículos y categorías populares
* Hacer seguimiento de los precios y los datos de ventas
* Extraer reseñas de clientes

<div id="scrape-with-json-mode">
  ## Scraping con modo JSON
</div>

Extrae datos estructurados de listados usando esquemas Zod.

```typescript theme={null}
import { Firecrawl } from 'firecrawl';
import { z } from 'zod';

// Definir esquema de Zod
const ListingSchema = z.object({
    title: z.string(),
    price: z.string(),
    shopName: z.string(),
    rating: z.number()
});

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const result = await firecrawl.scrape('https://www.etsy.com/listing/1844315896/handmade-925-sterling-silver-jewelry-set', {
    formats: [{
        type: 'json',
        schema: z.toJSONSchema(ListingSchema)
    }],
});

// Parsear y validar con Zod
const jsonData = typeof result.json === 'string' ? JSON.parse(result.json) : result.json;
const validated = ListingSchema.parse(jsonData);

console.log('✅ Validated listing data:');
console.log(validated);
```

<div id="search">
  ## Búsqueda
</div>

Busca productos en el marketplace de Etsy.

```typescript theme={null}
import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const searchResult = await firecrawl.search('handmade jewelry site:etsy.com', {
    limit: 10,
    sources: [{ type: 'web' }], // { type: 'news' }, { type: 'images' }
    scrapeOptions: {
        formats: ['markdown']
    }
});

console.log(searchResult);
```

<div id="scrape">
  ## Scrape
</div>

Extrae un único listado de producto de Etsy.

```typescript theme={null}
import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const result = await firecrawl.scrape('https://www.etsy.com/listing/1844315896/handmade-925-sterling-silver-jewelry-set', {
    formats: ['markdown'], // p. ej. html, links, etc.
    onlyMainContent: true
});

console.log(result);
```

<div id="map">
  ## Map
</div>

Descubre todas las URL disponibles de una tienda o categoría de Etsy. Nota: Map solo devuelve URL, sin contenido.

```typescript theme={null}
import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const mapResult = await firecrawl.map('https://www.etsy.com/shop/YourShopName');

console.log(mapResult.links);
// Devuelve un array de URLs sin contenido
```

<div id="crawl">
  ## Crawl
</div>

Rastrea varias páginas de una tienda o categoría de Etsy.

```typescript theme={null}
import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const crawlResult = await firecrawl.crawl('https://www.etsy.com/c/jewelry', {
    limit: 10,
    scrapeOptions: {
        formats: ['markdown']
    }
});

console.log(crawlResult.data);
```

<div id="batch-scrape">
  ## Scraping en lote
</div>

Haz scraping de varias URL de listados de Etsy simultáneamente.

```typescript theme={null}
import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

// Esperar finalización
const job = await firecrawl.batchScrape([
    'https://www.etsy.com/listing/1844315896/handmade-925-sterling-silver-jewelry-set',
    'https://www.etsy.com/market/handmade_jewelry',
    'https://www.etsy.com/market/jewelry_handmade'],
    {
        options: {
            formats: ['markdown']
        },
        pollInterval: 2,
        timeout: 120
    }
);


console.log(job.status, job.completed, job.total);

console.log(job);
```