# Etsy Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/etsy/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/etsy-product |

## Description

Fetch a single Etsy listing by ID or URL and get full product details: price, description, images, materials, seller info, and reviews.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/etsy/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Fetch listing by URL

```json
{
  "url": "https://www.etsy.com/listing/1584729301/handmade-ceramic-coffee-mug-pottery-mug",
  "tags": [
    "ceramic mug",
    "handmade mug",
    "pottery",
    "coffee mug",
    "stoneware",
    "gift",
    "kitchen"
  ],
  "price": 34,
  "title": "Handmade Ceramic Coffee Mug, Pottery Mug with Handle, Stoneware Mug 12oz",
  "views": 28430,
  "images": [
    "https://i.etsystatic.com/28471930/r/il/a3c4f1/4721830291/il_794xN.4721830291_k4m9.jpg",
    "https://i.etsystatic.com/28471930/r/il/b5d2e8/4721830299/il_794xN.4721830299_m3p7.jpg",
    "https://i.etsystatic.com/28471930/r/il/c7e4a2/4721830307/il_794xN.4721830307_n2q5.jpg",
    "https://i.etsystatic.com/28471930/r/il/d9f5b3/4721830315/il_794xN.4721830315_p8r1.jpg"
  ],
  "rating": 4.9,
  "category": "home-and-living",
  "currency": "USD",
  "ships_to": [
    "United States",
    "Canada",
    "United Kingdom",
    "Australia",
    "France",
    "Germany"
  ],
  "materials": [
    "stoneware clay",
    "food-safe glaze"
  ],
  "seller_id": "28471930",
  "created_at": "2023-03-14T09:22:41.000Z",
  "is_digital": false,
  "is_vintage": false,
  "listing_id": "1584729301",
  "seller_url": "https://www.etsy.com/shop/ClayworksByMara",
  "ships_from": "United States",
  "updated_at": "2024-11-07T16:48:03.000Z",
  "description": "Each mug is thrown on the wheel and glazed by hand in my home studio in Portland, Oregon. The stoneware clay is fired to cone 6 in an electric kiln, making it food-safe, microwave-safe, and dishwasher-safe. Dimensions: approximately 3.5 inches tall and 3.25 inches wide. Holds 12oz.",
  "is_handmade": true,
  "seller_name": "ClayworksByMara",
  "review_count": 1247,
  "seller_rating": 4.9,
  "shipping_cost": null,
  "favorites_count": 5812,
  "seller_location": "United States",
  "is_free_shipping": true,
  "quantity_available": 43,
  "seller_sales_count": 12051,
  "seller_review_count": 8374,
  "estimated_delivery_days_max": 7,
  "estimated_delivery_days_min": 3
}
```

### Fetch listing by ID

```json
{
  "url": "https://www.etsy.com/listing/1498302741/vintage-bifold-leather-wallet",
  "tags": [
    "leather wallet",
    "bifold",
    "minimalist",
    "men gift",
    "slim wallet",
    "full-grain"
  ],
  "price": 28,
  "title": "Vintage Bifold Leather Wallet, Minimalist Card Holder, Men's Slim Wallet",
  "views": 14210,
  "images": [
    "https://i.etsystatic.com/19384721/r/il/c2f4b7/3847201938/il_794xN.3847201938_t5w1.jpg",
    "https://i.etsystatic.com/19384721/r/il/d3a8f2/3847201946/il_794xN.3847201946_u4x2.jpg"
  ],
  "rating": 4.8,
  "category": "accessories",
  "currency": "USD",
  "ships_to": [
    "Everywhere"
  ],
  "materials": [
    "full-grain leather",
    "waxed thread"
  ],
  "seller_id": "19384721",
  "created_at": "2022-09-08T14:31:22.000Z",
  "is_digital": false,
  "is_vintage": false,
  "listing_id": "1498302741",
  "seller_url": "https://www.etsy.com/shop/LeatherCraftCo",
  "ships_from": "Poland",
  "updated_at": "2024-10-15T09:12:47.000Z",
  "description": "Handcrafted from full-grain vegetable-tanned leather. Each wallet develops a unique patina over time. Fits 6-8 cards plus folded bills. Dimensions: 4.3 x 3.4 inches when closed.",
  "is_handmade": true,
  "seller_name": "LeatherCraftCo",
  "review_count": 643,
  "seller_rating": 4.9,
  "shipping_cost": 4.5,
  "favorites_count": 2937,
  "seller_location": "Poland",
  "is_free_shipping": true,
  "quantity_available": 27,
  "seller_sales_count": 6249,
  "seller_review_count": 4812,
  "estimated_delivery_days_max": 14,
  "estimated_delivery_days_min": 7
}
```

## Documentation

## Overview
Etsy product pages require bypassing Cloudflare and parsing a JS-rendered DOM. Piloterr handles that: one GET request returns the full listing record as clean JSON.

## Quickstart
```
GET https://api.piloterr.com/v2/etsy/product?query=1584729301
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Etsy listing URL or numeric ID |

## Main use cases
- Enrich product databases with Etsy listing details for comparison engines
- Monitor specific listings for price changes and stock drops
- Collect seller performance data for vendor intelligence platforms
- Pull live listing data into your own storefront or catalog
- Validate product authenticity claims from seller descriptions and tags

Get access at https://www.piloterr.com/pricing