EveryData platform API
Etsy API
Etsy exposes five action-specific views for listings, product details, shops, and shop reviews: `search`, `profile`, `reviews`, `shop`, and `product_detail`.
Etsy begins with `search`, where `keyword` selects matching public results; the adjacent `profile` view uses `url` for the selected Etsy record, leaving other capabilities unclaimed.
- Endpoint
- POST /api/v1/social
- Capabilities
- 5
- Per 1,000
- $1.389
Available capabilities
Compare the Etsy actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Use Etsy | keyword | category, currency, exclude_keywords, min_price, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | listing_id · title · url · price · list_price · currency · rating · rating_scale · shop_id · shop_name · shop_rating · shop_review_count · on_sale · free_shipping · is_digital · image_url · platform |
profileProduct details Use Etsy | url | — | Sync delivery | — | $1.39 per 1,000 requests | listing_id · title · url · description · materials · category · price · price_min · price_max · currency · review_count · shop_id · shop_name · shop_review_count · shop_years · ships_from_country · image_url · platform · tag · count |
reviewsReviews The | shop | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | review_id · text · rating · rating_scale · author_name · author_username · posted_at · listing_title · seller_response · product_url · shop_name · shop_url · shop_rating · shop_review_count · platform |
shopShop Etsy | shop | shop_name, url, username | Sync delivery | — | $1.39 per 1,000 requests | shop_id · shop_name · shop_url · is_star_seller · active_listing_count · on_etsy_since · location · platform |
product_detailProduct details Use Etsy | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · text · price · original_price · currency · in_stock_quantity · rating · rating_scale · review_count · shop_id · variants · tags · image_url · platform |
What does each Etsy action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Etsy search parameters mean?
Use Etsy search to discover Etsy public results. Etsy search returns a request-scoped discovery sample. Call Etsy search with category, min_price, sort, currency, exclude_keywords, and keyword; Etsy search exposes shop_id, rating, list_price, currency, title, image_url, shop_rating, is_digital, listing_id, platform, url, on_sale, free_shipping, rating_scale, shop_name, shop_review_count, and price.
keywordRequired- Specifies the search query string for Etsy product searches (for example, ceramic mug) to query item titles and listings. It is not an exact match shop lookup; use shop to retrieve shop profiles or reviews.
categoryOptional- Filters Etsy search results by item category. Allowed values include any (unfiltered), jewelry-and-accessories, clothing-and-shoes, home-and-living, wedding-and-party, toys-and-entertainment, art-and-collectibles, craft-supplies-and-tools, vintage, gifts, electronics-and-accessories, bags-and-purses, and bath-and-beauty.
currencyOptional- Sets the listing price currency in search results using one of the supported lowercase currency codes, defaulting to usd. The min_price parameter is interpreted in this currency. This setting affects response display values only and does not alter platform API billing currencies.Allowed values:
audbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd exclude_keywordsOptional- Excludes items whose titles contain any specified string in this array (for example, ["digital", "download"]). Comparisons are case-insensitive. This filter only checks item titles and does not exclude specific sellers or guarantee scanning full item descriptions.
min_priceOptional- Filters Etsy product search results by minimum listing price using a non-negative number in the specified currency. It does not represent minimum order quantities, maximum shipping charges, or request budget limits.
sortOptional- Controls product search result ordering for the Etsy search action. Supported values are relevance (default), price_asc, price_desc, and newest. The legacy compatibility aliases most_relevant, lowest_price, highest_price, and recently_listed are also supported. This parameter does not sort shop reviews.
What do the Etsy profile parameters mean?
Use Etsy profile to read one Etsy public record. For Etsy profile, url selects the Etsy record. For Etsy profile, supply url; results include price_max, shop_review_count, price, image_url, shop_years, count, listing_id, platform, review_count, ships_from_country, url, shop_id, materials, tag, category, price_min, shop_name, currency, title, and description.
urlRequired- Accepts a full Etsy listing URL in the format /listing/<ID>/ for profile and product_detail actions to fetch single item product details. Note that profile targets item details rather than user profiles. It cannot replace the required shop parameter when querying shop endpoints.
What do the Etsy reviews parameters mean?
The reviews action fetches review records for an Etsy shop. The shop input is required, and optional fields serve only as filters. For Etsy reviews, supply shop; results include shop_rating, rating_scale, author_username, platform, shop_url, product_url, listing_title, posted_at, shop_review_count, review_id, text, shop_name, author_name, rating, and seller_response.
shopRequired- Identifies the shop using either its short name or a full URL like https://www.etsy.com/shop/<shop_name>. For the reviews action, it returns shop-level reviews rather than individual listing reviews; for the shop action, it retrieves general shop metadata.Etsy: Shop Link FormatsOfficial Etsy documentation states that shop links contain the shop short name, such as www.etsy.com/shop/shopname. Use the shop short name or a /shop/ link as specified by this parameter, and do not substitute product listing links for shop links.Checked
What do the Etsy shop parameters mean?
Etsy shop requires its documented Etsy selector. Etsy shop may omit unavailable public fields. Call Etsy shop with shop_name, username, shop, and url; Etsy shop exposes shop_name, platform, on_etsy_since, active_listing_count, shop_url, shop_id, is_star_seller, and location.
shopRequired- Identifies the shop using either its short name or a full URL like https://www.etsy.com/shop/<shop_name>. For the reviews action, it returns shop-level reviews rather than individual listing reviews; for the shop action, it retrieves general shop metadata.Etsy: Shop Link FormatsOfficial Etsy documentation states that shop links contain the shop short name, such as www.etsy.com/shop/shopname. Use the shop short name or a /shop/ link as specified by this parameter, and do not substitute product listing links for shop links.Checked
shop_nameOptional- Serves as a compatibility input representing the Etsy shop short name. The required primary shop parameter must still be included in calls to the reviews or shop actions.
urlOptional- Accepts a full Etsy listing URL in the format /listing/<ID>/ for profile and product_detail actions to fetch single item product details. Note that profile targets item details rather than user profiles. It cannot replace the required shop parameter when querying shop endpoints.
usernameOptional- Acts as a fallback compatibility input for the shop short name with lower precedence than shop and shop_name. It does not represent a buyer username, and the required shop parameter must still be supplied.
What do the Etsy product_detail parameters mean?
Use Etsy product_detail with url; Etsy then selects one product record. Variants absent from one product record must not be assumed unavailable across the whole listing. For Etsy product_detail, supply url; results include image_url, rating, price, in_stock_quantity, id, text, name, variants, review_count, rating_scale, original_price, platform, tags, shop_id, currency, and url.
urlRequired- Accepts a full Etsy listing URL in the format /listing/<ID>/ for profile and product_detail actions to fetch single item product details. Note that profile targets item details rather than user profiles. It cannot replace the required shop parameter when querying shop endpoints.
How to use the Etsy API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"etsy","action":"search","params":{"keyword":"<keyword>"}}'
Etsy API questions
What can I retrieve with the Etsy API?
Set platform to etsy. The current catalog lists search, product details, reviews, shop, and product details. These action names identify different Etsy objects or views; they are not interchangeable search modes.
Which input starts a Etsy `search` request?
Specifies the search query string for Etsy product searches (for example, ceramic mug) to query item titles and listings. It is not an exact match shop lookup; use shop to retrieve shop profiles or reviews. Send it as keyword inside params.
Which fields can Etsy `search` return?
Its declared schema includes listing_id, title, price, and list_price. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Etsy action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.