Etsy
Overview
Handmade and vintage marketplace — search listings, view details, shop profiles, and reviews.
Workflows
Search and view listing
searchListings(query) → listingId, shopNamegetListingDetail(listingId) → title, price, description, photos, seller
Read listing reviews
searchListings(query) → listingIdgetReviews(listingId) → averageRating, reviews[]
Browse a shop
searchListings(query) → shopNamegetShop(shopName) → rating, sales, location, owner
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchListings |
search items by keyword |
query |
listingId, title, price, shopName, rating |
entry point |
| getListingDetail |
full listing info |
listingId ← searchListings |
title, price, description, photos, shopName, material |
|
| getReviews |
listing reviews |
listingId ← searchListings |
averageRating, totalReviews, reviews[] |
LD+JSON provides ~4 recent reviews |
| getShop |
shop profile |
shopName ← searchListings |
name, location, rating, sales, owner, activeListings |
|
Quick Start
# Search for handmade pottery
openweb etsy exec searchListings '{"query":"handmade pottery"}'
# Get listing details
openweb etsy exec getListingDetail '{"listingId":"168685596"}'
# Get reviews for a listing
openweb etsy exec getReviews '{"listingId":"168685596"}'
# Get shop profile
openweb etsy exec getShop '{"shopName":"nealpottery"}'
1---2name: etsy3description: Etsy4---5# Etsy67## Overview8Handmade and vintage marketplace — search listings, view details, shop profiles, and reviews.910## Workflows1112### Search and view listing131. `searchListings(query)` → `listingId`, `shopName`142. `getListingDetail(listingId)` → title, price, description, photos, seller1516### Read listing reviews171. `searchListings(query)` → `listingId`182. `getReviews(listingId)` → averageRating, reviews[]1920### Browse a shop211. `searchListings(query)` → `shopName`222. `getShop(shopName)` → rating, sales, location, owner2324## Operations2526| Operation | Intent | Key Input | Key Output | Notes |27|-----------|--------|-----------|------------|-------|28| searchListings | search items by keyword | query | listingId, title, price, shopName, rating | entry point |29| getListingDetail | full listing info | listingId ← searchListings | title, price, description, photos, shopName, material | |30| getReviews | listing reviews | listingId ← searchListings | averageRating, totalReviews, reviews[] | LD+JSON provides ~4 recent reviews |31| getShop | shop profile | shopName ← searchListings | name, location, rating, sales, owner, activeListings | |3233## Quick Start3435```bash36# Search for handmade pottery37openweb etsy exec searchListings '{"query":"handmade pottery"}'3839# Get listing details40openweb etsy exec getListingDetail '{"listingId":"168685596"}'4142# Get reviews for a listing43openweb etsy exec getReviews '{"listingId":"168685596"}'4445# Get shop profile46openweb etsy exec getShop '{"shopName":"nealpottery"}'47```
spike-faye-lei