플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Etsy 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword로 Etsy 상품 정보를 검색합니다. | 요청 1,000개당 $1.39 | 정상 |
상품 상세 정보profile | 상품 페이지 url로 Etsy 상품 하나의 전체 레코드를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | Etsy 숍 단위 리뷰를 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
숍shop | shop에 이름이나 URL을 넣어 Etsy 숍을 조회하고 ID, 위치, 개설일, 판매 중인 상품 수, Star Seller 배지를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
상품 상세 정보product_detail | 상품 페이지 url로 Etsy 상품 하나를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Etsy 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | currency, exclude_keywords, min_price, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | 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 |
profile상품 상세 정보 상품 페이지 | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | 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 · images · review_highlights · review_tags · variants |
reviews리뷰 Etsy 숍 단위 리뷰를 조회합니다. | shop | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | 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 |
shop숍
| shop | shop_name, username | Sync 응답 | — | 요청 1,000개당 $1.39 | shop_id · shop_name · shop_url · is_star_seller · active_listing_count · on_etsy_since · location · platform |
product_detail상품 상세 정보 상품 페이지 | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · price · original_price · currency · in_stock_quantity · rating · rating_scale · review_count · shop_id · variants · tags · image_url · platform |
Etsy search 파라미터는 각각 무엇을 의미하나요?
keyword로 Etsy 상품 정보를 검색합니다. 상품별 가격, 정가, 통화, 평점, 판매 숍을 가져옵니다. 선택 필터로 통화, 제목 제외어, 최소 가격, 정렬을 지정할 수 있습니다. 상품 정보만으로 수제품 여부, 재고, 배송이 보장되지는 않습니다.
keyword필수- Etsy 상품 검색어를 지정해(예: ceramic mug) 상품 제목과 상품 정보를 조회합니다. 상점을 정확한 이름으로 조회하는 기능이 아니며, 상점 프로필이나 리뷰를 가져오려면 shop을 사용합니다.
currency선택- 지원되는 소문자 통화 코드 중 하나로 검색 결과의 상품 가격 통화를 지정하며, 기본값은 usd입니다. min_price 파라미터는 이 통화 기준으로 해석됩니다. 이 설정은 응답에 표시되는 값에만 영향을 주며, 플랫폼 API 과금 통화는 바뀌지 않습니다.허용 값:
audbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd exclude_keywords선택- 제목에 이 배열의 문자열 중 하나라도 포함된 상품을 제외합니다(예: ["digital", "download"]). 대소문자는 구분하지 않습니다. 이 필터는 상품 제목만 확인하며, 특정 판매자를 제외하거나 상품 설명 전체를 검사한다고 보장하지 않습니다.
min_price선택- 지정한 통화 기준의 0 이상 숫자로 최소 상품 가격을 지정해 Etsy 상품 검색 결과를 필터링합니다. 최소 주문 수량, 최대 배송비, 요청 예산 한도를 의미하지 않습니다.
sort선택- Etsy search 액션의 상품 검색 결과 정렬 순서를 지정합니다. 지원 값은 relevance(기본값), price_asc, price_desc, newest입니다. 이전 버전 호환용 별칭인 most_relevant, lowest_price, highest_price, recently_listed도 지원합니다. 이 파라미터는 상점 리뷰를 정렬하지 않습니다.허용 값:
newestprice_ascprice_descrelevance
Etsy profile 파라미터는 각각 무엇을 의미하나요?
상품 페이지 url로 Etsy 상품 하나의 전체 레코드를 가져옵니다. 설명, 소재, 가격대, 옵션, 주요 리뷰, 판매 숍 정보가 포함됩니다. 액션 이름과 달리 profile은 구매자 계정이나 숍 전체 페이지가 아닌 상품을 다룹니다.
url필수- profile과 product_detail 액션에서 단일 상품의 상세 정보를 가져오기 위해 /listing/<ID>/ 형식의 Etsy 상품 정보 전체 URL을 받습니다. profile은 사용자 프로필이 아니라 상품 상세 정보를 대상으로 한다는 점에 유의해야 합니다. 상점 엔드포인트를 조회할 때 필수 파라미터인 shop을 대신할 수 없습니다.
Etsy reviews 파라미터는 각각 무엇을 의미하나요?
Etsy 숍 단위 리뷰를 조회합니다. shop에 숍 단축 이름이나 숍 URL을 전달하세요. 평점, 작성자, 관련 상품명, 판매자 답변을 가져옵니다. 리뷰는 개별 상품이 아닌 숍 전체에 대한 것입니다. 한 번에 가져온 리뷰가 모든 판매를 반영하지는 않습니다.
shop필수- 상점의 짧은 이름 또는 https://www.etsy.com/shop/<shop_name> 같은 전체 URL로 상점을 지정합니다. reviews 액션에서는 개별 상품 리뷰가 아닌 상점 단위 리뷰를 반환하고, shop 액션에서는 상점의 일반 메타데이터를 가져옵니다.Etsy: 숍 링크 형식 — Etsy 공식 문서에 따르면 숍 링크에는 www.etsy.com/shop/shopname처럼 숍 단축 이름이 포함됩니다. 이 파라미터에 명시된 대로 숍 단축 이름이나 /shop/ 링크를 사용해야 하며, 숍 링크 대신 상품 페이지 링크를 넣으면 안 됩니다. · 확인일
Etsy shop 파라미터는 각각 무엇을 의미하나요?
shop에 이름이나 URL을 넣어 Etsy 숍을 조회하고 ID, 위치, 개설일, 판매 중인 상품 수, Star Seller 배지를 가져옵니다. is_star_seller는 확인 시점의 배지 상태이며 향후 서비스 품질을 약속하지 않습니다.
shop필수- 상점의 짧은 이름 또는 https://www.etsy.com/shop/<shop_name> 같은 전체 URL로 상점을 지정합니다. reviews 액션에서는 개별 상품 리뷰가 아닌 상점 단위 리뷰를 반환하고, shop 액션에서는 상점의 일반 메타데이터를 가져옵니다.Etsy: 숍 링크 형식 — Etsy 공식 문서에 따르면 숍 링크에는 www.etsy.com/shop/shopname처럼 숍 단축 이름이 포함됩니다. 이 파라미터에 명시된 대로 숍 단축 이름이나 /shop/ 링크를 사용해야 하며, 숍 링크 대신 상품 페이지 링크를 넣으면 안 됩니다. · 확인일
shop_name선택- Etsy 상점의 짧은 이름을 나타내는 호환용 입력입니다. reviews 또는 shop 액션을 호출할 때는 여전히 필수 기본 파라미터인 shop을 포함해야 합니다.
username선택- 상점 짧은 이름의 대체 호환용 입력으로, shop과 shop_name보다 우선순위가 낮습니다. 구매자 사용자 이름을 의미하지 않으며, 필수 파라미터인 shop을 여전히 전달해야 합니다.
Etsy product_detail 파라미터는 각각 무엇을 의미하나요?
상품 페이지 url로 Etsy 상품 하나를 가져옵니다. 설명, 현재 가격과 원래 가격, 표시된 재고 수량, 평점, 옵션, 태그가 포함됩니다. in_stock_quantity는 페이지에 표시된 수량이며 실사를 거친 재고가 아닙니다. 이 조회로 상품이 확보되지는 않습니다.
url필수- profile과 product_detail 액션에서 단일 상품의 상세 정보를 가져오기 위해 /listing/<ID>/ 형식의 Etsy 상품 정보 전체 URL을 받습니다. profile은 사용자 프로필이 아니라 상품 상세 정보를 대상으로 한다는 점에 유의해야 합니다. 상점 엔드포인트를 조회할 때 필수 파라미터인 shop을 대신할 수 없습니다.
Etsy API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
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 자주 묻는 질문
Etsy API로 무엇을 가져올 수 있나요?
platform을 etsy 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상품 상세 정보, 리뷰, 숍 및 상품 상세 정보입니다. 각 액션 이름은 서로 다른 Etsy 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Etsy search 요청에는 어떤 입력이 필요한가요?
Etsy 상품 검색어를 지정해(예: ceramic mug) 상품 제목과 상품 정보를 조회합니다. 상점을 정확한 이름으로 조회하는 기능이 아니며, 상점 프로필이나 리뷰를 가져오려면 shop을 사용합니다. params 안의 keyword 필드로 전달하세요.
Etsy search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 listing_id, title, price 및 list_price입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Etsy 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.