Xianyu API
Xianyu(Goofish)는 Alibaba의 중고 거래 마켓플레이스입니다. search는 키워드와 일치하는 상품 정보를 반환합니다. item_detail은 숫자 상품 ID 또는 goofish.com 상품 링크로 여러 상품 정보를 일괄 조회하며, 상품 정보 1건당 1행을 반환합니다.
중고 상품은 금방 팔리거나 내려가므로 모든 행은 요청 시점의 스냅샷입니다. 검색 결과의 want_count는 상품 카드에서 가져오며, 카드에 표시되지 않으면 null입니다. item_detail은 10점 척도의 상품 상태, 조회 수와 찜 수, 모든 사진, 상품 설명, 판매자의 긍정 리뷰 비율을 추가로 제공합니다. 읽을 수 없는 상품 정보는 missed로 반환되며 과금되지 않습니다.
플랫폼 가용성
- 24시간 상태
- 99%
최근 30일
제공 기능
각 Xianyu 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
Xianyu 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 검색어로 Xianyu의 중고 상품 정보를 호출당 최대 50개까지 둘러봅니다. 가격, 도시, 찜 수, 태그, 경매 여부, 판매자의 신용 등급을 가져옵니다. 중국어 검색어와 모델 번호가 판매자 제목과 가장 잘 일치합니다. | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $5.56 | item_id · url · title · price · original_price · currency · city · image_url · want_count · tags · category_id · free_shipping · is_auction · has_video · posted_at · seller_id · seller_name · seller_avatar_url · seller_credit_label · platform |
item_detail상품 정보 상세 상품 ID 또는 goofish.com 링크 1~20개로 Xianyu 상품 정보 전체를 가져옵니다. 설명, 상태 점수, 배송비, 위치, 상세한 판매자 통계가 포함됩니다. | urls | — | Sync 응답 | — | 요청 1,000개당 $5.56 | item_id · url · title · text · price · original_price · currency · shipping_fee · condition_level · status · quantity · want_count · view_count · collect_count · sold_count · province · city · category_id · image_url · images · posted_at · seller_id · seller_name · seller_url · seller_item_count · seller_sold_count · seller_good_review_rate · seller_reply_rate_24h · district · division_id · lat · lng · poi_name · poi_id · seller_avatar_url · seller_city · seller_bio · seller_joined_at · seller_last_seen · seller_zhima_verified · seller_zhima_level · seller_zhima_level_code · seller_credit_level · seller_identity_tags · seller_other_items · platform |
Xianyu search 파라미터는 각각 무엇을 의미하나요?
검색어로 Xianyu의 중고 상품 정보를 호출당 최대 50개까지 둘러봅니다. 가격, 도시, 찜 수, 태그, 경매 여부, 판매자의 신용 등급을 가져옵니다. 중국어 검색어와 모델 번호가 판매자 제목과 가장 잘 일치합니다. want_count가 null이면 0이 아니라 카드에 표시되지 않았다는 뜻입니다.
keyword필수search에 쓰는 Xianyu 검색어로, 1~100자입니다. 영어 번역어보다 중국어 용어와 모델 번호가 판매자의 상품명과 더 잘 일치합니다. 상품 ID나 판매자 이름이 아닙니다.
Xianyu item_detail 파라미터는 각각 무엇을 의미하나요?
상품 ID 또는 goofish.com 링크 1~20개로 Xianyu 상품 정보 전체를 가져옵니다. 설명, 상태 점수, 배송비, 위치, 상세한 판매자 통계가 포함됩니다. condition_level은 10점 척도를 사용합니다. sold_count는 Xianyu가 숨기면 null입니다. 읽을 수 없는 상품 정보는 환불 대상입니다.
urls필수item_detail에 쓰는 1~20개의 Xianyu 상품 정보로 이루어진 배열입니다. 각 항목은 숫자 상품 ID(search가 반환하는item_id) 또는https://www.goofish.com/item?id=<digits>링크이며, 동일한 상품 정보는 한 번만 포함할 수 있습니다. 상품 정보별로 과금되며, 읽을 수 없는 상품 정보에 대해서는 환불됩니다. 앱 공유 단축 링크는 허용되지 않습니다.Alibaba 오픈 플랫폼: Xianyu 상품 ID와 상품 상태 등급 — 승인된 Xianyu ISV 파트너용 Alibaba 상품 조회 API는 숫자로 된 Xianyu 상품 ID로 상품 정보 하나를 식별하고, stuff_status로 상태 등급을 매깁니다. 100은 새 상품, 95는 95% 새 상품, -1은 거의 새 상품입니다. 호출하려면 Alibaba 파트너 환경 안에서 권한을 받아야 합니다. 이 자료는 ID와 상태 용어만 확인해 주며, EveryInfra가 이 API를 사용하거나 임의 상품 정보의 모든 필드를 읽을 수 있다는 뜻은 아닙니다. · 확인일
Xianyu 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":"xianyu","action":"search","params":{"keyword":"<keyword>"}}'
Xianyu API 자주 묻는 질문
Xianyu API로 무엇을 가져올 수 있나요?
platform을 xianyu 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색 및 상품 정보 상세입니다. 각 액션 이름은 서로 다른 Xianyu 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Xianyu search 요청에는 어떤 입력이 필요한가요?
search에 쓰는 Xianyu 검색어로, 1~100자입니다. 영어 번역어보다 중국어 용어와 모델 번호가 판매자의 상품명과 더 잘 일치합니다. 상품 ID나 판매자 이름이 아닙니다. params 안의 keyword 필드로 전달하세요.
Xianyu search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 item_id, title, price 및 original_price입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Xianyu 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. item_detail runs 동기 방식으로만 실행됩니다. 반환하는 모든 데이터를(배치의 모든 대상 또는 상품의 모든 SKU) 같은 호출 안에서 읽어 오기 때문이며, "mode": "async"가 포함된 요청은 과금 전에 422를 받습니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.