Skip to main content

Commerce Long-Tail

Long-tail commerce data beyond the big marketplaces: product search across eBay / Etsy / AliExpress / Shopify, single-product lookup, and public social follower metrics (with a fake-follower estimate). These endpoints cover the marketplaces Pry's Marketplace domain (Amazon, Walmart, TikTok Shop) doesn't — hand-made goods, resale, cross-border, and independent Shopify stores.

What it scrapes​

SourceData
eBay / Etsy / AliExpress / ShopifyProduct search + single-product detail (price, seller, rating where available)
Instagram / TikTok / YouTube public profilesFollower counts, engagement rate, fake-follower estimate

Endpoints​

Router: routers/commerce_data.py · tag: Commerce Data

MethodPathSummary
GET/v1/commerce/searchSearch products across eBay, Etsy, AliExpress, or a Shopify store
GET/v1/commerce/platformsList supported marketplaces / platforms
GET/v1/commerce/syncCommerce sync status / targets
GET/v1/commerce/{marketplace}/{product_id}Single product by id on a marketplace
GET/v1/social/{platform}/{handle}Public follower metrics for a social profile

GET /v1/commerce/search​

Query params: query (required), marketplace (ebay | etsy | aliexpress | shopify, default ebay), limit (1–250, default 20).

curl -X GET "http://localhost:8005/v1/commerce/search?query=vintage+camera&marketplace=etsy&limit=2" \
  -H "Authorization: Bearer <key>"

Response (200):

{
  "success": true,
  "query": "vintage camera",
  "marketplace": "etsy",
  "limit": 2,
  "data": [
    {
      "id": "2401234567",
      "title": "Vintage 1970s Rangefinder Camera",
      "price": 89.5,
      "currency": "USD",
      "seller": "AnalogShop",
      "rating": 4.9,
      "url": "https://www.etsy.com/listing/2401234567",
      "marketplace": "etsy"
    }
  ]
}

GET /v1/commerce/{marketplace}/{product_id}​

Path params: marketplace (ebay | etsy | aliexpress | shopify), product_id (for shopify: store:id or store:handle).

curl -X GET "http://localhost:8005/v1/commerce/etsy/2401234567" \
  -H "Authorization: Bearer <key>"

Response (200): same product record shape as search.

GET /v1/social/{platform}/{handle}​

Path params: platform (e.g. instagram, tiktok, youtube), handle.

curl -X GET "http://localhost:8005/v1/social/tiktok/examplebrand" \
  -H "Authorization: Bearer <key>"

Response (200):

{
  "success": true,
  "data": {
    "handle": "examplebrand",
    "platform": "tiktok",
    "followers": 1234000,
    "following": 128,
    "posts": 342,
    "avg_engagement": 0.042,
    "fake_follower_estimate": 0.18
  }
}

MCP tools​

Commerce long-tail is REST-first today; the marketplace lane (pry_amazon_product, pry_amazon_search, pry_walmart_product, pry_tiktok_trending) is exposed over MCP. The full 50-tool list is in MCP Integration.

Who uses this​

  • Resellers / dropshippers — cross-marketplace pricing and inventory.
  • Brand monitoring — Shopify store product tracking and competitor launches.
  • Influencer vetting — follower/engagement sanity checks with fake-follower estimates before sponsorships.

Next steps​