플랫폼 가용성
- 24시간 상태
- 99%
최근 30일
제공 기능
각 AliExpress 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 상품 키워드로 AliExpress 상품 정보를 둘러봅니다. | 요청 1,000개당 $1.3950행마다 호출 1회로 계산 | 정상 |
상세 정보profile | AliExpress 상품 링크를 열어 상품 페이지를 JSON으로 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
Variantsvariants | AliExpress 상품의 옵션과 SKU를 나열합니다. | 요청 1,000개당 $1.39 | 양호 · 상태 99% |
리뷰reviews | AliExpress 상품의 구매자 리뷰를 수집합니다. | 요청 1,000개당 $1.39 | 정상 |
평점 요약ratings | AliExpress 상품 하나의 평균 별점과 전체 리뷰 수를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
상품 상세 정보product_detail | AliExpress 상품 하나의 전체 상품 페이지를 가져옵니다. | 요청 1,000개당 $1.39 | 양호 · 상태 99% |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
AliExpress 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 상품 키워드로 AliExpress 상품 정보를 둘러봅니다. 가격과 정가, 할인, 주문 수, 평점, 발송지, 판매자를 비교할 수 있습니다. 최소 가격, 최소 별점, 정렬 순서로 필터링할 수 있습니다. 수치는 각 상품 정보에 대한 것이며 수요나 마진을 나타내지 않습니다. | keyword | min_price, min_rating, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.3950행마다 호출 1회로 계산 | product_id · title · url · price · original_price · currency · discount · rating · rating_scale · orders_count · review_count · image_url · ships_from · seller_name · category · is_top_rated · free_shipping · images · search_rank · seller_rating · seller_url · platform · tags |
profile상세 정보 AliExpress 상품 링크를 열어 상품 페이지를 JSON으로 가져옵니다. 제목, 가격, 통화, 평점, 판매 수량, 배송, 스토어 정보, 재고 관련 신호를 가져옵니다. 이름과 달리 | url | country, currency | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
variantsVariants AliExpress 상품의 옵션과 SKU를 나열합니다. 상품 정보에 표시된 경우 각 옵션의 속성, 색상, 이미지, 가격이 포함됩니다. 특정 조합이 없다고 해서 품절이라는 뜻은 아니며, 이 목록이 전체 재고 기록은 아닙니다. | url | country, currency | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
reviews리뷰 AliExpress 상품의 구매자 리뷰를 수집합니다. 별점, 국가, 구매한 옵션, 배송 방법, 리뷰가 도움이 됐다는 평가 수, 사진이 포함됩니다. | url | sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · is_anonymous · unhelpful_count · language · original_text · is_translated · review_labels · sku_id · platform · images |
ratings평점 요약 AliExpress 상품 하나의 평균 별점과 전체 리뷰 수를 읽어 옵니다. 별점별 분포와 긍정·중립·부정 비율은 일시적으로 제공되지 않습니다. 개별 리뷰는 | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · platform |
product_detail상품 상세 정보 AliExpress 상품 하나의 전체 상품 페이지를 가져옵니다. 가격과 할인, 판매 수량, 평점, 배송, 옵션, 속성, 총 재고, 스토어 정보가 포함됩니다. | url | country, currency | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
AliExpress search 파라미터는 각각 무엇을 의미하나요?
상품 키워드로 AliExpress 상품 정보를 둘러봅니다. 가격과 정가, 할인, 주문 수, 평점, 발송지, 판매자를 비교할 수 있습니다. 최소 가격, 최소 별점, 정렬 순서로 필터링할 수 있습니다. 수치는 각 상품 정보에 대한 것이며 수요나 마진을 나타내지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- 상품 정보 목록을 반환할 상품 검색어(예: 무선 이어폰)를 지정합니다. 판매자 ID가 아니라 검색 키워드를 전달하세요. 상품 상세 정보, 옵션, 리뷰는 상품 URL로 조회합니다.
min_price선택- 검색 시 이보다 저렴한 상품을 제외하는 최저 상품 가격 기준값(숫자)을 설정합니다. 할인율이나 API 요청 예산이 아니라 상품 가격 필터이며, 결과의 통화는 검색 메타데이터에 따라 달라집니다.
min_rating선택- 0~5 숫자 척도(예: 4.5)의 최소 별점으로 상품 검색을 필터링합니다. 리뷰 수, 긍정 피드백 비율, 개별 리뷰 점수가 아니라 상품 전체 평점을 기준으로 합니다.
sort선택- 허용 값으로 액션 결과를 정렬합니다. search에서는 relevance(기본값), popular, price_asc, price_desc, top_rated를 사용할 수 있으며, 레거시 값 default, orders, rating도 지원합니다. reviews에서는 relevance(기본값)와 newest를 사용할 수 있으며, newest는 상품 등록일이 아니라 리뷰 작성일 기준으로 정렬합니다. ratings는 정렬을 지원하지 않습니다.허용 값:
popularprice_ascprice_descrelevancetop_rated
AliExpress profile 파라미터는 각각 무엇을 의미하나요?
AliExpress 상품 링크를 열어 상품 페이지를 JSON으로 가져옵니다. 제목, 가격, 통화, 평점, 판매 수량, 배송, 스토어 정보, 재고 관련 신호를 가져옵니다. 이름과 달리 profile은 구매자 프로필이 아니라 상품을 설명합니다. 재고 수치가 실제 재고를 보장하지는 않습니다.
url필수- 전체 URL(예: https://www.aliexpress.com/item/<item_id>.html)로 대상 AliExpress 상품을 지정합니다. url은 profile에서 상품 메타데이터를, variants에서 SKU를, reviews나 ratings에서 피드백 요약을 가져올 때 사용하며, product_detail에도 사용합니다(product_detail은 숫자 상품 ID도 허용).
country선택- profile, variants, product_detail이 상품을 조회할 국가 또는 지역 코드입니다(예: US, 기본값 US, 대문자로 변환). 상품의 지역별 화면을 선택할 뿐, 계정 국가나 실제 주문의 배송 주소는 바뀌지 않습니다.
currency선택- profile, variants, product_detail이 반환하는 상품 가격의 통화입니다(예: USD, 기본값 USD, 대문자로 변환). 표시 가격만 바뀌며, EveryInfra API 호출 과금 방식과는 관계가 없습니다.
AliExpress variants 파라미터는 각각 무엇을 의미하나요?
AliExpress 상품의 옵션과 SKU를 나열합니다. 상품 정보에 표시된 경우 각 옵션의 속성, 색상, 이미지, 가격이 포함됩니다. 특정 조합이 없다고 해서 품절이라는 뜻은 아니며, 이 목록이 전체 재고 기록은 아닙니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 전체 URL(예: https://www.aliexpress.com/item/<item_id>.html)로 대상 AliExpress 상품을 지정합니다. url은 profile에서 상품 메타데이터를, variants에서 SKU를, reviews나 ratings에서 피드백 요약을 가져올 때 사용하며, product_detail에도 사용합니다(product_detail은 숫자 상품 ID도 허용).AliExpress: 카테고리별 SKU 속성과 일반 속성 — 오픈 플랫폼의 속성 조회 엔드포인트는 카테고리 아래의 SKU 속성과 일반 속성을 구분하며, 속성 이름, 속성 값, 필수 여부 같은 필드를 제공합니다. 이 설명은 AliExpress의 옵션(variant) 용어를 명확히 하기 위한 것이며, 이 엔드포인트가 상품 등록을 지원하거나 모든 카테고리 조합을 반환한다고 보장하지 않습니다. · 확인일
country선택- profile, variants, product_detail이 상품을 조회할 국가 또는 지역 코드입니다(예: US, 기본값 US, 대문자로 변환). 상품의 지역별 화면을 선택할 뿐, 계정 국가나 실제 주문의 배송 주소는 바뀌지 않습니다.
currency선택- profile, variants, product_detail이 반환하는 상품 가격의 통화입니다(예: USD, 기본값 USD, 대문자로 변환). 표시 가격만 바뀌며, EveryInfra API 호출 과금 방식과는 관계가 없습니다.
AliExpress reviews 파라미터는 각각 무엇을 의미하나요?
AliExpress 상품의 구매자 리뷰를 수집합니다. 별점, 국가, 구매한 옵션, 배송 방법, 리뷰가 도움이 됐다는 평가 수, 사진이 포함됩니다. is_translated가 true이면 text는 번역문이고 original_text에 작성자가 쓴 원문이 담깁니다.
url필수- 전체 URL(예: https://www.aliexpress.com/item/<item_id>.html)로 대상 AliExpress 상품을 지정합니다. url은 profile에서 상품 메타데이터를, variants에서 SKU를, reviews나 ratings에서 피드백 요약을 가져올 때 사용하며, product_detail에도 사용합니다(product_detail은 숫자 상품 ID도 허용).
sort선택- 허용 값으로 액션 결과를 정렬합니다. search에서는 relevance(기본값), popular, price_asc, price_desc, top_rated를 사용할 수 있으며, 레거시 값 default, orders, rating도 지원합니다. reviews에서는 relevance(기본값)와 newest를 사용할 수 있으며, newest는 상품 등록일이 아니라 리뷰 작성일 기준으로 정렬합니다. ratings는 정렬을 지원하지 않습니다.허용 값:
newestrelevance
AliExpress ratings 파라미터는 각각 무엇을 의미하나요?
AliExpress 상품 하나의 평균 별점과 전체 리뷰 수를 읽어 옵니다. 별점별 분포와 긍정·중립·부정 비율은 일시적으로 제공되지 않습니다. 개별 리뷰는 reviews를 사용하세요.
url필수- 전체 URL(예: https://www.aliexpress.com/item/<item_id>.html)로 대상 AliExpress 상품을 지정합니다. url은 profile에서 상품 메타데이터를, variants에서 SKU를, reviews나 ratings에서 피드백 요약을 가져올 때 사용하며, product_detail에도 사용합니다(product_detail은 숫자 상품 ID도 허용).
AliExpress product_detail 파라미터는 각각 무엇을 의미하나요?
AliExpress 상품 하나의 전체 상품 페이지를 가져옵니다. 가격과 할인, 판매 수량, 평점, 배송, 옵션, 속성, 총 재고, 스토어 정보가 포함됩니다. country와 currency로 지역 기준을 설정하며, sold_text는 정확한 수량이 아니라 페이지에 표시된 반올림 수치입니다.
url필수- 전체 URL(예: https://www.aliexpress.com/item/<item_id>.html)로 대상 AliExpress 상품을 지정합니다. url은 profile에서 상품 메타데이터를, variants에서 SKU를, reviews나 ratings에서 피드백 요약을 가져올 때 사용하며, product_detail에도 사용합니다(product_detail은 숫자 상품 ID도 허용).
country선택- profile, variants, product_detail이 상품을 조회할 국가 또는 지역 코드입니다(예: US, 기본값 US, 대문자로 변환). 상품의 지역별 화면을 선택할 뿐, 계정 국가나 실제 주문의 배송 주소는 바뀌지 않습니다.
currency선택- profile, variants, product_detail이 반환하는 상품 가격의 통화입니다(예: USD, 기본값 USD, 대문자로 변환). 표시 가격만 바뀌며, EveryInfra API 호출 과금 방식과는 관계가 없습니다.
AliExpress 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":"aliexpress","action":"search","params":{"keyword":"<keyword>"}}'
AliExpress 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
가격 스크래핑의 상업화: 판매자가 구독을 갱신하는 가격 모니터링 제품 만들기
판매자는 왜 가격 모니터링에 돈을 내고, 왜 구독을 해지할까요? 상품 매칭, 예외 목록, 가격 승인 워크플로를 통해 가격 데이터 제공 방식, 과금 단위, 파일럿 인수 기준을 살펴봅니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기API 실패, 크레딧 환불, 대사: 요청 한 건의 순과금액을 감사하는 방법
작업, 호출 시도, 전달 상태, 지갑 이벤트를 분리해 과금 전 거부, 빈 결과, 부분 크레딧 환불을 중복 집계 없이 처리하며, 정수 기반 오프라인 예시를 사용합니다.
글 읽기AliExpress API 자주 묻는 질문
AliExpress API로 무엇을 가져올 수 있나요?
platform을 aliexpress 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상세 정보, variants, 리뷰, 평점 요약 및 more입니다. 각 액션 이름은 서로 다른 AliExpress 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
AliExpress에 공식 API가 있나요?
AliExpress Open Platform은 판매자, 제휴 파트너, 드롭쉬퍼를 위한 API를 제공합니다. 판매자용 API는 스토어 운영자가 앱에 권한을 부여한 스토어에서만 작동하며 해당 스토어의 상품과 주문을 다룹니다. 제휴 파트너는 먼저 AliExpress Portals 퍼블리셔로 등록하고 개발자 프로필 승인을 받아야 합니다.
공식 출처: AliExpress Open Platform: Global APIs overview · AliExpress Open Platform: affiliate quick start · 확인일
AliExpress 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. AliExpress 개발자 앱을 등록하거나, AliExpress API 접근을 신청하거나, AliExpress 계정으로 로그인할 필요가 없으며, 액션은 공개된 AliExpress 데이터만 반환합니다.
AliExpress API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $1.39이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
AliExpress search 요청에는 어떤 입력이 필요한가요?
상품 정보 목록을 반환할 상품 검색어(예: 무선 이어폰)를 지정합니다. 판매자 ID가 아니라 검색 키워드를 전달하세요. 상품 상세 정보, 옵션, 리뷰는 상품 URL로 조회합니다. params 안의 keyword 필드로 전달하세요.
AliExpress search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 product_id, title, price 및 original_price입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 AliExpress 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.