플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 eBay 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword에 해당하는 eBay 상품 정보를 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
스토어store | 정확한 seller 사용자 이름으로 eBay 판매자 스토어의 상품 정보를 가져오며, 상품별 가격, 상태, 배송, 이미지를 포함합니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | eBay 상품 하나에 대한 구매자 피드백을 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
판매 완료된 상품 정보sold | keyword에 대해 지정한 최근 일수 동안 완료된 eBay 판매 내역을 추적합니다. | 요청 1,000개당 $1.39 | 정상 |
상품 상세 정보product_detail | 링크나 숫자 상품 ID로 eBay 상품 정보 하나를 전체 조회합니다. | 요청 1,000개당 $0.96 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
eBay 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | condition, country, domain, max_price, min_price, sold_only | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
store스토어 정확한 | seller | country, domain, store, url, username | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
reviews리뷰 eBay 상품 하나에 대한 구매자 피드백을 조회합니다. | seller, item_id | country, domain, product_id, q, seller_name, url, username | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | text · rating · rating_scale · username · submitted_at · seller_reply · image_count · reviewer_feedback_score · reviewer_feedback_star · product_name · product_id · product_price · platform · image_url · images |
sold판매 완료된 상품 정보
| keyword | days, min_price, site, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · name · sold_price · shipping_price · total_price · currency · sold_at · condition · listing_type · best_offer_accepted · category · seller_username · seller_feedback_score · seller_positive_percent · image_url · platform |
product_detail상품 상세 정보 링크나 숫자 상품 ID로 eBay 상품 정보 하나를 전체 조회합니다. 가격, 상태, 재고 여부, 판매 방식, 가격 제안(Best Offer) 가능 여부, 배송 및 반품, 관심 등록자 수, 브랜드와 카탈로그 코드, 카테고리 경로, 모든 이미지, 판매자의 피드백 점수와 긍정 비율을 제공합니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.96 | item_id · title · subtitle · url · price · currency · condition · availability · listing_type · bid_count · best_offer_enabled · ends_at · quantity_available · quantity_sold · watchers · brand · model · mpn · gtin · product_id · categories · image_url · images · item_location · shipping_price · free_shipping · returns_accepted · seller · seller_url · seller_feedback_score · seller_positive_percent · updated_at · platform |
eBay search 파라미터는 각각 무엇을 의미하나요?
keyword에 해당하는 eBay 상품 정보를 찾습니다. 판매 희망가, 통화, 상태, 배송 조건, 판매자를 가져옵니다. 상태, 사이트 도메인, 가격대로 필터링할 수 있습니다. sold_only는 판매 완료로 확인된 상품 정보만 남기며, 전체 시장 거래량을 측정하지는 않습니다.
keyword필수search액션에서는 판매 중인 상품 정보를,sold액션에서는 종료되었거나 판매 완료된 상품 정보를 찾는 검색어입니다. 판매 중인 상품 정보의 호가가 최종 거래 금액과 같다고 가정하면 안 됩니다.condition선택- 상품 상태로 검색 결과를 필터링합니다. New, Used, Refurbished, For parts or not working 중 하나를 대소문자와 공백까지 그대로 사용해야 합니다. 긍정/부정 리뷰 필터가 아니라 상품 상태 필터입니다.
country선택- domain의 호환용 입력으로, US나 DE 같은 국가 코드가 아닌 ebay.com 같은 eBay 사이트 도메인을 받습니다. 둘 다 지정하면 domain이 우선합니다.
domain선택- ebay.com, ebay.de, ebay.co.uk 등 eBay 사이트 도메인을 스킴이나 경로 없이 선택합니다. 기본값은 ebay.com이며, search, store, reviews 페이지를 구성하는 데 사용합니다.
max_price선택- search에서 상품 가격의 숫자 상한을 지정합니다. min_price와 함께 사용해 범위를 정할 수 있으며, 배송비나 세금이 포함되어 있다고 가정하면 안 됩니다.
min_price선택- 상품 가격의 숫자 하한을 지정합니다.
search액션에서는 판매 중인 상품 정보의 가격을,sold액션에서는 종료되었거나 판매 완료된 상품 정보의 가격을 필터링합니다. 통화는 API 과금이 아니라 대상 마켓플레이스 사이트와 상품 정보 데이터에 따라 결정됩니다.sold에서는 정수로 필터링하며 소수점 이하는 버립니다. sold_only선택search액션에서true로 설정하면 거래가 완료된 판매 건만 반환하는 불리언 토글입니다. 문자열("false")이 아닌 JSON 불리언으로 전달해야 합니다.
eBay store 파라미터는 각각 무엇을 의미하나요?
정확한 seller 사용자 이름으로 eBay 판매자 스토어의 상품 정보를 가져오며, 상품별 가격, 상태, 배송, 이미지를 포함합니다. 상품 정보만 제공되며 판매자의 잔액, 비공개 평판, 내부 재고는 포함되지 않습니다.
seller필수- 정확한 eBay 판매자 계정 사용자 이름으로, 스토어 표시 이름이나 회사명이 아닙니다.
store쿼리에서는 판매자의 상품 정보를 가져오는 데,reviews쿼리에서는item_id와 함께 구매자 피드백을 조회하는 데 사용합니다. country선택- domain의 호환용 입력으로, US나 DE 같은 국가 코드가 아닌 ebay.com 같은 eBay 사이트 도메인을 받습니다. 둘 다 지정하면 domain이 우선합니다.
domain선택- ebay.com, ebay.de, ebay.co.uk 등 eBay 사이트 도메인을 스킴이나 경로 없이 선택합니다. 기본값은 ebay.com이며, search, store, reviews 페이지를 구성하는 데 사용합니다.
store선택- 판매자 계정 사용자 이름을 나타내는
seller의 호환용 별칭으로, 임의의 상점 이름이 아닙니다.store액션에는 여전히 기본 파라미터인seller가 필요합니다. url선택- 자동 URL 구성 대신,
store액션에서는 eBay 스토어/판매자 상품 정보 페이지를,reviews액션에서는/fdbk/피드백 페이지를 직접 지정합니다. URL을 지정해도seller또는item_id파라미터는 여전히 필요합니다. username선택store와reviews액션에서 사용하는seller계정 사용자 이름의 호환용 별칭입니다.seller파라미터가 우선하며 여전히 필수입니다. 이 필드는 구매자나 리뷰 작성자의 핸들을 의미하지 않습니다.
eBay reviews 파라미터는 각각 무엇을 의미하나요?
eBay 상품 하나에 대한 구매자 피드백을 조회합니다. seller 사용자 이름과 item_id로 상품을 지정합니다. 평점, 판매자 답변, 리뷰 작성자 본인의 피드백 점수, 상품 정보를 가져옵니다. 전체 피드백 기록이 모두 포함된다는 보장은 없습니다.
seller필수- 정확한 eBay 판매자 계정 사용자 이름으로, 스토어 표시 이름이나 회사명이 아닙니다.
store쿼리에서는 판매자의 상품 정보를 가져오는 데,reviews쿼리에서는item_id와 함께 구매자 피드백을 조회하는 데 사용합니다.eBay: 거래 피드백 프로필 — eBay 거래 피드백은 짧은 의견이 붙은 긍정, 중립, 부정 평가로 이루어지며, 회원의 피드백 프로필은 일반적인 5점 만점 상품 리뷰와 다른 개념입니다. · 확인일 item_id필수- 판매자 상품 정보에 연결된 숫자 형식의 eBay 상품 식별자로(보통
/itm/URL에서 추출),reviews쿼리에서seller와 함께 사용합니다. 일반적인 카탈로그 상품 ID나 리뷰 항목 ID가 아닌 특정 상품 정보를 나타냅니다. country선택- domain의 호환용 입력으로, US나 DE 같은 국가 코드가 아닌 ebay.com 같은 eBay 사이트 도메인을 받습니다. 둘 다 지정하면 domain이 우선합니다.
domain선택- ebay.com, ebay.de, ebay.co.uk 등 eBay 사이트 도메인을 스킴이나 경로 없이 선택합니다. 기본값은 ebay.com이며, search, store, reviews 페이지를 구성하는 데 사용합니다.
product_id선택- 숫자 형식의 eBay 상품 식별자를 받는
item_id의 호환용 별칭입니다.reviews액션에는 여전히item_id가 필요합니다. q선택reviews액션에서 숫자 형식의 eBay 상품 식별자를 받는item_id의 호환용 별칭입니다. 자유 텍스트 검색어로는 사용하지 않으며, 상품 검색에는keyword를 사용합니다.seller_name선택- eBay 판매자 계정 사용자 이름입니다.
url선택- 자동 URL 구성 대신,
store액션에서는 eBay 스토어/판매자 상품 정보 페이지를,reviews액션에서는/fdbk/피드백 페이지를 직접 지정합니다. URL을 지정해도seller또는item_id파라미터는 여전히 필요합니다. username선택store와reviews액션에서 사용하는seller계정 사용자 이름의 호환용 별칭입니다.seller파라미터가 우선하며 여전히 필수입니다. 이 필드는 구매자나 리뷰 작성자의 핸들을 의미하지 않습니다.
eBay sold 파라미터는 각각 무엇을 의미하나요?
keyword에 대해 지정한 최근 일수 동안 완료된 eBay 판매 내역을 추적합니다. 판매 가격, 배송비, 총액, 판매일, 판매 방식, 판매자 피드백을 가져옵니다. 각 결과는 종료된 개별 상품 정보를 나타내며, 순매출이나 향후 수요를 추정하지 않습니다.
keyword필수search액션에서는 판매 중인 상품 정보를,sold액션에서는 종료되었거나 판매 완료된 상품 정보를 찾는 검색어입니다. 판매 중인 상품 정보의 호가가 최종 거래 금액과 같다고 가정하면 안 됩니다.days선택sold쿼리에서 과거 조회 기간을 일 단위로 나타내는 정수입니다(기본값30). 상품 정보 게시 기간이나 반환 항목 수가 아니라 기간 범위를 의미하며, 임의의 기간에 대해 레코드 전체를 보장하지 않습니다.min_price선택- 상품 가격의 숫자 하한을 지정합니다.
search액션에서는 판매 중인 상품 정보의 가격을,sold액션에서는 종료되었거나 판매 완료된 상품 정보의 가격을 필터링합니다. 통화는 API 과금이 아니라 대상 마켓플레이스 사이트와 상품 정보 데이터에 따라 결정됩니다.sold에서는 정수로 필터링하며 소수점 이하는 버립니다. site선택sold쿼리에 사용할 eBay 도메인을 지정하며(예:ebay.com또는ebay.co.uk), 기본값은ebay.com입니다.search,store,reviews액션에서 사용하는domain파라미터와는 별개이며, 가격 통화는 반환된 상품 정보 레코드를 따릅니다.sort선택sold액션의 정렬 순서로, 허용 값은newest(최근 종료순)와distance(거리순)입니다. 최초 상품 등록일 기준으로는 정렬하지 않습니다. 생략하면 최근 종료순으로 정렬됩니다.허용 값:distancenewest
eBay product_detail 파라미터는 각각 무엇을 의미하나요?
링크나 숫자 상품 ID로 eBay 상품 정보 하나를 전체 조회합니다. 가격, 상태, 재고 여부, 판매 방식, 가격 제안(Best Offer) 가능 여부, 배송 및 반품, 관심 등록자 수, 브랜드와 카탈로그 코드, 카테고리 경로, 모든 이미지, 판매자의 피드백 점수와 긍정 비율을 제공합니다. bid_count, ends_at 같은 경매 필드와 gtin 같은 코드는 상품 정보에 표시된 경우에만 포함됩니다.
url필수- eBay 상품 정보 1개의 링크(예: https://www.ebay.com/itm/133576802017, 추적 파라미터와 제목 부분은 제거됩니다) 또는 숫자 상품 ID입니다. ID만 입력하면 ebay.com에서 조회합니다. 다른 eBay 사이트의 링크는 해당 사이트에서 조회합니다. 스토어 페이지, 검색 페이지, 목록은 호출이 실행되기 전에 거부됩니다.
eBay 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":"ebay","action":"search","params":{"keyword":"<keyword>"}}'
eBay API 자주 묻는 질문
eBay API로 무엇을 가져올 수 있나요?
platform을 ebay 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 스토어, 리뷰, 판매 완료된 상품 정보 및 상품 상세 정보입니다. 각 액션 이름은 서로 다른 eBay 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
eBay search 요청에는 어떤 입력이 필요한가요?
search 액션에서는 판매 중인 상품 정보를, sold 액션에서는 종료되었거나 판매 완료된 상품 정보를 찾는 검색어입니다. 판매 중인 상품 정보의 호가가 최종 거래 금액과 같다고 가정하면 안 됩니다. params 안의 keyword 필드로 전달하세요.
eBay search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 item_id, title, price 및 price_text입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 eBay 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.