跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
数据与分析

etsy-product-data

Search Etsy listings, pull one listing with its variations and reviews, open a shop's profile and catalogue, and page through a shop's reviews. 5 endpoints, 2 credits each, structured JSON.

scavio-ai · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add scavio-ai/skills --skill etsy-product-data

技能说明


name: etsy-product-data description: Search Etsy listings, pull one listing with its variations and reviews, open a shop's profile and catalogue, and page through a shop's reviews. 5 endpoints, 2 credits each, structured JSON. version: 1.0.0 tags: etsy, etsy-api, product-data, ecommerce, handmade, product-search, listings, product-reviews, shop-data, seller-analytics, market-research, price-comparison, craft, agents, structured-data, json, ai-agents, scraping-api metadata: openclaw: requires: env: - SCAVIO_API_KEY primaryEnv: SCAVIO_API_KEY timeout: 120 throttle: 1 emoji: "\U0001F3A8" homepage: https://scavio.dev/docs?utm_source=agent-skills&utm_medium=skill&utm_campaign=etsy-product-data

Etsy Product Data API - Listings, Shops, Reviews

Search Etsy listings, pull one listing in full with its variations and reviews, open a shop's profile and catalogue, and page through a shop's reviews. All endpoints return structured JSON.

When to trigger

Use this skill when the user asks to:

  • Search Etsy for a product, with price, on-sale and free-shipping filters, sorted by relevance, price or newest
  • Pull one listing in full - description, price, availability, material, category path, ship-from, all images, buyer-selectable variations, aggregate rating and its first page of reviews
  • Read a shop's profile: location, year opened, sales and admirer counts, rating, review and listing counts, star-seller flag, announcement and sections
  • List a shop's own listings
  • Page through a shop's reviews across all its listings
  • Do handmade/craft market research, competitor shop analysis or price comparison on Etsy

Setup

Get a free API key at scavio.dev (50 free credits to get started, no card required):

export SCAVIO_API_KEY=sk_live_your_key

If you do not have a key yet

An agent running this skill without SCAVIO_API_KEY set will get 401 on every call below. The whole path from nothing to a working key is self-serve:

  1. Sign up at dashboard.scavio.dev - email or Google, no card required.
  2. A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
  3. A new account starts with 50 credits. Endpoints in this skill cost 1 credit each unless the table below says otherwise.

When the balance runs out the API answers 402 with a JSON body carrying billing_url. Topping up needs no code change - the same key keeps working. The smallest purchase is 2,500 credits for $25, and monthly plans work out cheaper per credit if the usage is steady rather than one-off.

Every request is a POST with a JSON body and:

Authorization: Bearer $SCAVIO_API_KEY

Endpoints

Base URL: https://api.scavio.dev. Every Etsy endpoint costs 2 credits.

EndpointCreditsWhat it returns
POST /api/v1/etsy/search2Listings for a query: title, price with discounts, image, shop, per-listing rating and review count, ad and free-shipping flags. Paginated by page
POST /api/v1/etsy/product2One listing in full: description, price, availability, material, category path, ship-from, all images, buyer-selectable variations, aggregate rating, first page of reviews, and the shop
POST /api/v1/etsy/shop2A shop's profile and stats: headline, location, logo/banner, year opened, sales and admirer counts, rating, review and listing counts, star-seller flag, announcement, about and sections
POST /api/v1/etsy/shop/products2A page of a shop's listings, same card shape as search (shop-grid cards carry no per-card rating)
POST /api/v1/etsy/reviews2A shop's reviews, paginated across all its listings (~14 per page): rating, author, date, text, reviewer avatar, and the source listing

Which endpoint has the reviews

A listing's own first-page reviews ride the product endpoint. The reviews endpoint returns a shop's reviews pooled across all its listings. Use product for one item, reviews for the whole shop.

Parameters

Search (/search)

ParameterTypeDefaultDescription
querystringrequiredSearch terms (1-500 chars)
pageinteger--1-based results page
sortstringrelevancerelevance, lowest_price, highest_price, most_recent
min_price / max_pricenumber--Price filter, in USD
free_shippingboolean--Only listings that offer free shipping
on_saleboolean--Only listings currently discounted

Product (/product)

ParameterTypeDefaultDescription
listingstringrequiredListing id or a listing URL containing /listing/<id>/

Shop (/shop), Shop Products (/shop/products), Reviews (/reviews)

ParameterTypeDefaultDescription
shopstringrequiredShop name or a shop URL like https://www.etsy.com/shop/StonehousePotteryOH
pageinteger--1-based page (shop/products and reviews)
sortstringrelevance(shop/products only) same values as search

Examples

import requests

BASE = "https://api.scavio.dev"
# Your key from https://scavio.dev. Load it from your environment or secret
# store in real code - keep it out of source control.
API_KEY = "sk_your_key_here"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Search, newest first, on sale only
found = requests.post(f"{BASE}/api/v1/etsy/search", headers=HEADERS,
    json={"query": "ceramic mug", "sort": "most_recent", "on_sale": True,
          "max_price": 40}).json()

row = found["data"]["items"][0]
listing_id, shop = row["listing_id"], row["shop"]

# 2. One listing in full - variations, aggregate rating
阅读完整来源 ↗