Etsy Product Description

Etsy Product Description API Documentation

Retrieve detailed information about an Etsy product listing, including its title, description, images, pricing, variations, reviews, and more. This API is perfect for integrating Etsy product data into your applications, improving marketing campaigns, or powering ecommerce tools.

Parameters

Name	Type	Description	Required	Default
listingId	String	Unique identifier for the Etsy product listing.	Yes	N/A
currency	String	The currency for the product's price (e.g., USD).	No	USD
language	String	Language code for the product description (e.g., en-GB).	No	en-GB
country	String	The country code (e.g., US).	No	US

---

Example Response

1{
2  "title": "14K Solid Gold Family Birthstone Necklace, Birthstone Gift, Christmas Gift, Bridesmaid Gift, Gift for Mom, Birthday Gift, Birthstone Jewelry",
3  "productId": "1301638116",
4  "gtin": "n/a",
5  "description": "Silver Birthstone Necklace, Personalized Gifts, 14k Solid Gold Birthstone Jewelry, Family Necklace For Grandmothers, Christmas Gift, Best Gifts for Mothers, Personalized Birthstone Necklace, Family Birthstone Necklace, Birthstone Gift, Dainty Necklace, Gift For Her, Birthday Gift\n\n☆ Back to my store for more options: https://www.etsy.com/shop/aceelegance\n\n☆ All the pieces you purchased from AceElegance come with a Certificate of Authenticity (925 Sterling Silver, 8k Solid Gold, 14k Solid Gold, 18k Solid Gold)\n\n☆ www.aceelegance.com ☆\n\n[...truncated for brevity...]",
6  "images": [
7    "https://i.etsystatic.com/27808603/r/il/17eff8/4476872409/il_fullxfull.4476872409_hru6.jpg",
8    "https://i.etsystatic.com/27808603/r/il/dd8d66/4292154829/il_fullxfull.4292154829_7ikv.jpg",
9    "https://i.etsystatic.com/27808603/r/il/0ba591/4244514176/il_fullxfull.4244514176_fm31.jpg",
10    "https://i.etsystatic.com/27808603/r/il/abc9bc/4292145011/il_fullxfull.4292145011_thdf.jpg"
11  ],
12  "price": {
13    "salePrice": "14.67",
14    "originalPrice": "26.67",
15    "currency": "$",
16    "discount": "45% off"
17  },
18  "variations": [
19    {
20      "options1": [
21        { "value": "2922229031", "text": "Silver-1 Birthstone ($18.33)" },
22        { "value": "2922229041", "text": "Silver-2 Birthstones ($21.99)" }
23      ]
24    },
25    {
26      "options2": [
27        { "value": "2922229033", "text": "14 Inches" },
28        { "value": "2922229035", "text": "15 Inches" }
29      ]
30    }
31  ],
32  "category": [
33    "Jewellery",
34    "Necklaces",
35    "Charm Necklaces"
36  ],
37  "brand": {
38    "name": "AceElegance",
39    "logo": "https://i.etsystatic.com/isla/e9d72e/60194815/isla_500x500.60194815_ndw6wt55.jpg?version=0"
40  },
41  "url": "https://www.etsy.com/listing/1301638116/14k-solid-gold-family-birthstone",
42  "ratingSummary": {
43    "ratingValue": "4.8",
44    "reviewCount": 15678
45  },
46  "review": [
47    {
48      "@type": "Review",
49      "reviewRating": {
50        "@type": "Rating",
51        "ratingValue": 5,
52        "bestRating": 5
53      },
54      "datePublished": "2024-11-22",
55      "reviewBody": "The necklace came in the cutest little packaging and was absolutely perfect. My grandmother is gonna love it",
56      "author": {
57        "@type": "Person",
58        "name": "Raven Nellenback"
59      }
60    },
61    {
62      "@type": "Review",
63      "reviewRating": {
64        "@type": "Rating",
65        "ratingValue": 5,
66        "bestRating": 5
67      },
68      "datePublished": "2024-11-21",
69      "reviewBody": "Cannot wait to give this to my mother in law for Christmas :)",
70      "author": {
71        "@type": "Person",
72        "name": "Megan Marchase"
73      }
74    }
75  ]
76}

---

Description of Response

Field	Type	Description
title	String	The product's name or title.
productId	String	Unique identifier for the product.
gtin	String	Global Trade Item Number if available.
description	String	Detailed description of the product.
images	Array	List of URLs for product images.
price	Object	Pricing information including sale and original prices, currency, and discount.
variations	Array	Available variations such as colors, sizes, or styles.
category	Array	Hierarchical category for the product.
brand	Object	Brand details including name and logo.
url	String	Direct URL to the product page on Etsy.
ratingSummary	Object	Summary of product ratings and total review count.
review	Array	List of recent reviews with rating, date, content, and reviewer details.

---

Here's an enhanced example of the Etsy Product Description API documentation, including a detailed description and FAQs with 10 questions and answers.

---

Etsy Product Description API

Retrieve detailed information about an Etsy product listing, including its title, description, images, pricing, variations, reviews, and more. This API is perfect for integrating Etsy product data into your applications, improving marketing campaigns, or powering ecommerce tools.

---

Endpoint

GET /etsy-product-description

---

Parameters

Parameter	Type	Required	Default Value	Description
listingId	String	Yes	N/A	The unique ID of the Etsy product listing to retrieve information about.
currency	String	No	USD	The currency format for the pricing information.
language	String	No	en-GB	The language format for the returned data.
country	String	No	US	The country format for the returned data.

---

Example Response

1{
2  "title": "14K Solid Gold Family Birthstone Necklace, Birthstone Gift, Christmas Gift, Bridesmaid Gift, Gift for Mom, Birthday Gift, Birthstone Jewelry",
3  "productId": "1301638116",
4  "gtin": "n/a",
5  "description": "Silver Birthstone Necklace, Personalized Gifts, ...",
6  "images": [
7    "https://i.etsystatic.com/27808603/r/il/17eff8/4476872409/il_fullxfull.4476872409_hru6.jpg",
8    "https://i.etsystatic.com/27808603/r/il/dd8d66/4292154829/il_fullxfull.4292154829_7ikv.jpg"
9  ],
10  "price": {
11    "salePrice": "14.67",
12    "originalPrice": "26.67",
13    "currency": "$",
14    "discount": "45% off"
15  },
16  "variations": [
17    {
18      "options1": [
19        { "value": "2922229031", "text": "Silver-1 Birthstone ($18.33)" }
20      ]
21    }
22  ],
23  "category": ["Jewellery", "Necklaces", "Charm Necklaces"],
24  "brand": {
25    "name": "AceElegance",
26    "logo": "https://i.etsystatic.com/isla/e9d72e/60194815/isla_500x500.60194815_ndw6wt55.jpg?version=0"
27  },
28  "url": "https://www.etsy.com/listing/1301638116/14k-solid-gold-family-birthstone",
29  "ratingSummary": {
30    "ratingValue": "4.8",
31    "reviewCount": 15678
32  },
33  "review": [
34    {
35      "reviewRating": { "ratingValue": 5, "bestRating": 5 },
36      "datePublished": "2024-11-22",
37      "reviewBody": "The necklace came in the cutest little packaging...",
38      "author": { "name": "Raven Nellenback" }
39    }
40  ]
41}

---

This API provides detailed information about a specific Etsy product listing. With the listing ID as input, the API returns:

• Product title, description, and category hierarchy.
• High-quality images for the listing.
• Pricing details, including sale price, original price, currency, and discounts.
• Available variations, such as material, color, and size.
• Brand details, including name and logo.
• Reviews and ratings from customers.
• Product URL for direct navigation.

This API is suitable for building ecommerce aggregators, powering marketing tools, or enhancing customer engagement with accurate product details.

---

FAQs

1. What is the purpose of the listingId parameter?
   The listingId identifies the specific Etsy product you want information about. It’s mandatory to ensure the API fetches the correct listing.

2. Can I retrieve information in a different currency?
   Yes, use the currency parameter to specify the desired currency. For example, use EUR for Euros or GBP for British Pounds.

3. What languages are supported?
   The API supports multiple languages. By default, it returns data in English (en-GB). Use the language parameter to set your preferred language.

4. What happens if the country parameter is not specified?
   If not provided, the API defaults to US. This affects shipping information and localized data.

5. Are the reviews limited in the response?
   The API typically returns the top 5 reviews. For more reviews, additional queries may be required.

6. How are discounts calculated in the price object?
   Discounts are calculated based on the difference between salePrice and originalPrice. The discount field shows the percentage reduction.

7. Can I use this API to list multiple Etsy products?
   Currently, the API supports fetching details for one product per request. Batch requests require individual calls.

8. What happens if the listing ID is invalid or not found?
   The API returns an error message indicating the issue. Ensure the listing ID is correct and active.

9. Are images returned in specific resolutions?
   Yes, the images are provided in high resolution, ideal for use in ecommerce platforms or marketing materials.

10. How often is the data updated?
    The data reflects Etsy’s most recent updates. If changes occur on Etsy (e.g., price updates), they will appear in API responses shortly after.

---