# Scrapier — Etsy API > Scrapier endpoints for Etsy: Etsy Product Info by Url, Etsy Product Reviews, Etsy Search by Keyword, Etsy Search Suggestions and 2 more. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/etsy.md ## GET /etsy-product-info-by-url/ Etsy Product Info by Url: Structured Etsy data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.product · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.etsy.com/listing/1215970085/custom-air-freshener): Etsy listing URL or bare listing id. One record per call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - country (optional, string, default US, locked in cursor): Ship-to country, ISO-2. - currency (optional, string, default USD, locked in cursor): ISO 4217 price currency. - language (optional, string, default en-US, locked in cursor): Listing copy language. - render (optional, string, one of: auto|http|browser, default auto): auto = HTTP (no browser) with browser fallback; http = never a browser. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/etsy-product-info-by-url/?urls=https%3A%2F%2Fwww.etsy.com%2Flisting%2F1215970085%2Fcustom-air-freshener" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/etsy/etsy-product-info-by-url.md ## GET /etsy-product-reviews/ Etsy Product Reviews: Structured Etsy data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.reviews Parameters: - urls (required, string, example RosysPatterns): Etsy listing URL / listing id (product reviews) or shop URL / shop name (shop reviews). Required on the first call (list -> first only). 24 reviews per page. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort_option (optional, string, one of: Recency|Relevancy|Highest|Lowest, default Recency, locked in cursor): - enrich_buyer_profiles (optional, boolean, default false, locked in cursor): - include_subratings (optional, boolean, default false, locked in cursor): Best-effort (DataDome-gated). - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/etsy-product-reviews/?urls=RosysPatterns" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/etsy/etsy-product-reviews.md ## GET /etsy-search-by-keyword/ Etsy Search by Keyword: Structured Etsy data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.listings Parameters: - queries (required, string, example handmade necklace): Plain Etsy search keywords. Required on the first call (list -> first only). One Etsy result page (~35-48 organic listings) per call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - enable_fallback (optional, boolean, default true): Web-search-index fallback for page 1 when the Etsy search API is unusable. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/etsy-search-by-keyword/?queries=handmade+necklace" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/etsy/etsy-search-by-keyword.md ## GET /etsy-search-suggestions/ Etsy Search Suggestions: Structured Etsy data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.suggestions Parameters: - queries (required, string, example leather): Partial Etsy search text. Required on the first call. 20 suggestions per page. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - locale (optional, string, one of: en-US|en-GB|en-CA|en-AU|en-IN|de|fr|es|it|nl|pt|pl|sv|ja|ru, default en-US, locked in cursor): Etsy suggestion language. - country (optional, string, default US, locked in cursor): ISO-2 region. - expand (optional, boolean, default true, locked in cursor): Alphabet expansion for pages beyond the base list. - expansion_alphabet (optional, string, locked in cursor): Blank = a-z0-9. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/etsy-search-suggestions/?queries=leather" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/etsy/etsy-search-suggestions.md ## GET /etsy-shop-products/ Etsy Shop Products: Structured Etsy data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.products Parameters: - urls (required, string, example https://www.etsy.com/shop/AceElegance): Etsy shop URL, bare shop name or numeric shop id. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort (optional, string, one of: most_recent|price_low|price_high|custom|relevance, default most_recent, locked in cursor): - currency (optional, string, default USD, locked in cursor): - search_query (optional, string, locked in cursor): In-shop keyword. - include_details (optional, boolean, default true, locked in cursor): - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/etsy-shop-products/?urls=https%3A%2F%2Fwww.etsy.com%2Fshop%2FAceElegance" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/etsy/etsy-shop-products.md ## GET /etsy-similar-products/ Etsy Similar Products: Structured Etsy data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.products Parameters: - urls (required, string, example 1215970085): Etsy listing URL or numeric listing id. Required on the first call (list -> first only). 20 products per page. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - country (optional, string, default US, locked in cursor): Ship-to country. - currency (optional, string, default USD, locked in cursor): Price currency. - locale (optional, string, default en-US, locked in cursor): Copy language. - include_unavailable (optional, boolean, default false, locked in cursor): - expand_similar (optional, boolean, default true, locked in cursor): Similar-of-similar expansion past ~40. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/etsy-similar-products/?urls=1215970085" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/etsy/etsy-similar-products.md