# Social Fetch API - Etsy endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 4 documented Etsy operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/etsy/listing Get Etsy listing Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/etsy/listing/get.mdx SDK: client.etsy.getListing({ listing: "1136507412" }) Parameters: - listing (required, string) - Etsy listing id, e.g. `1136507412`: the number in a listing's address. A listing URL such as https://www.etsy.com/listing/1136507412/ is also accepted. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/etsy/listing?listing=1136507412" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/etsy/listing/similar List Etsy similar listings Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/etsy/listing/similar/get.mdx SDK: client.etsy.listSimilarListings({ listing: "1136507412" }) Parameters: - listing (required, string) - Etsy listing id, e.g. `1136507412`: the number in a listing's address. A listing URL such as https://www.etsy.com/listing/1136507412/ is also accepted. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/etsy/listing/similar?listing=1136507412" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/etsy/shop/listings List Etsy shop listings Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/etsy/shop/listings/get.mdx SDK: client.etsy.listShopListings({ shop: "PlanetJune", sort: "newest" }) Parameters: - shop (required, string) - Etsy shop name, e.g. `PlanetJune`: the last part of the shop's address. A shop URL such as https://www.etsy.com/shop/PlanetJune is also accepted. Not case-sensitive. - sort (optional, string, enum: custom | newest | price_asc | price_desc) - Order: `custom` (the shop's own order), `newest`, `price_asc` or `price_desc`. Omit for the shop's default order. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/etsy/shop/listings?shop=PlanetJune" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/etsy/search/suggestions Get Etsy search suggestions Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/etsy/search/suggestions/get.mdx SDK: client.etsy.listSearchSuggestions({ query: "soap" }) Parameters: - query (required, string) - Text to complete, as typed into Etsy's search box, e.g. `soap` or `leather wal`. Outcome field: `data.lookupStatus` in `found` curl "https://api.socialfetch.dev/v1/etsy/search/suggestions?query=soap" \ -H "x-api-key: YOUR_API_KEY"