resale-secondhand-research

Resale & secondhand marketplace research

Search listings, sellers, and prices across nine C2C resale, streetwear, and handmade marketplaces as normalized JSON from the Crawlora API — no scraping app storefronts.

When to use this skill

• "Find <item> for sale on <platform>" / compare listings.
• "What's this seller's/shop's closet/storefront like?"
• "What's the resale price for these sneakers?" (StockX)
• "Find handmade/vintage <item>" (Etsy).
• "What's live right now?" (Whatnot livestream shopping).

Setup (one-time)

• Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
• Set CRAWLORA_API_KEY in the environment before running the helper.
• The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

1. Poshmark — /poshmark/search (query) to find listings;

/poshmark/listing/{id} for detail; /poshmark/closet/{username} for a seller's storefront; /poshmark/brand/{name} / /poshmark/category/{path} to browse.

1. Etsy — /etsy/search (q) for listings; /etsy/listing/{id} (+

/reviews) for detail; /etsy/shop/search / /etsy/shop/{id} (+ /listings, /reviews) for a shop's storefront.

1. Vinted — /vinted/catalog (search_text) for listings;

/vinted/item/{id} for detail; /vinted/member/{id} for a seller; /vinted/brand//vinted/category to filter by brand/category id (resolve ids via /vinted/brands//vinted/categories).

1. StockX — /stockx/search requires `category` (e.g. sneakers,

apparel, collectibles; query is the optional keyword within it) to find a slug, then /stockx/product/{slug} for market data; /stockx/releases for upcoming drops.

1. Mercari — /mercari/search (query) for listings;

/mercari/item/{id} for detail; /mercari/autocomplete for query suggestions.

1. Depop — /depop/search (query, plus filters like brand_ids,

condition, price_min/price_max) for listings; /depop/item/{slug} for detail; /depop/shop/{username} for a seller's storefront.

1. Whatnot — /whatnot/browse requires `category` to list live/

upcoming shows; /whatnot/live/{id} for one livestream's detail.

1. GOAT — /goat/search for sneaker, streetwear, and collectible products;

/goat/product/{slug} for pricing and product detail; /goat/collection, /goat/curated, /goat/suggest, and /goat/searches/trending for catalog discovery.

1. Leboncoin — /leboncoin/search for public listing cards and

/leboncoin/listing for one public ad's detail.

Full endpoint list, methods, and params: `reference/endpoints.md`.

Calling the API

# Search a marketplace:
scripts/crawlora.sh /poshmark/search query="vintage levis jacket" | jq '.'
scripts/crawlora.sh /etsy/search q="handmade ceramic mug" | jq '.'
scripts/crawlora.sh /vinted/catalog search_text="north face jacket" | jq '.'

# StockX (category required):
scripts/crawlora.sh /stockx/search category=sneakers query="jordan 4" | jq '.'

# Seller/shop lookup:
scripts/crawlora.sh /depop/shop/<handle> | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See `reference/endpoints.md` for every Poshmark, Etsy, Vinted, StockX, Mercari, Depop, Whatnot, GOAT, and Leboncoin endpoint this skill uses.

Examples

• Cross-platform price compare: search the same item on Poshmark,

Depop, Vinted, and Mercari, then diff asking prices.

• Sneaker resale check: /stockx/search category=sneakers query="..." →

/stockx/product/{slug} for current market price vs. retail.

• Seller vetting: /poshmark/closet/{username} or /depop/shop/{username}

before buying, to check listing count and activity.

• Handmade sourcing: /etsy/search for a category, then

/etsy/shop/{id}/reviews on top shops before ordering a custom piece.

• Sneaker/streetwear resale: /goat/search to find products, then

/goat/product/{slug} for current per-size pricing and stock.

• French secondhand listings: /leboncoin/search for a public location,

then /leboncoin/listing for a selected ad.

Notes & limits

• Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo.

Key at https://crawlora.net.

• Public data only — public listing/storefront pages; no purchases or

offers are made.

• Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
• StockX and Whatnot require a `category` on their search/browse

endpoints — check reference/endpoints.md for accepted values before calling.

• Vinted brand/category filters need numeric ids — resolve via

/vinted/brands//vinted/categories first if you only have a name.

• GOAT and Leboncoin calls can also consume Crawlora credits; keep the

marketplace and route in the user's requested scope before calling them.