Etsy Product Description
3 days trial then $27.99/month - No credit card required now
Etsy Product Description
3 days trial then $27.99/month - No credit card required now
Retrieve detailed information about an Etsy product listing, including its title, description, images, pricing, variations, reviews, and more.
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
-
What is the purpose of the
listingId
parameter?
ThelistingId
identifies the specific Etsy product you want information about. It’s mandatory to ensure the API fetches the correct listing. -
Can I retrieve information in a different currency?
Yes, use thecurrency
parameter to specify the desired currency. For example, useEUR
for Euros orGBP
for British Pounds. -
What languages are supported?
The API supports multiple languages. By default, it returns data in English (en-GB
). Use thelanguage
parameter to set your preferred language. -
What happens if the
country
parameter is not specified?
If not provided, the API defaults toUS
. This affects shipping information and localized data. -
Are the reviews limited in the response?
The API typically returns the top 5 reviews. For more reviews, additional queries may be required. -
How are discounts calculated in the
price
object?
Discounts are calculated based on the difference betweensalePrice
andoriginalPrice
. Thediscount
field shows the percentage reduction. -
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. -
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. -
Are images returned in specific resolutions?
Yes, the images are provided in high resolution, ideal for use in ecommerce platforms or marketing materials. -
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.
Actor Metrics
1 monthly user
-
1 star
>99% runs succeeded
Created in Nov 2024
Modified 11 days ago