11st Products Crawler

English | 한국어

English

Who this Actor is for

11st Products Crawler collects structured product search results from 11st.co.kr, a South Korean online marketplace. It is intended for price monitoring, seller research, market analysis, and data pipelines that need consistent search-result metadata.

The Actor calls 11st's search JSON API directly without launching a browser. Every saved product record follows the same 29-field schema.

Key features

• No browser — Sends direct JSON API requests without Playwright or browser rendering.
• Fixed 29-field output — Every Dataset item contains the same 29 keys.
• Ad handling — Identifies ads with isAd and can exclude them with excludeAds.
• Per-keyword deduplication — Removes duplicate productId values across pages for each keyword.
• Commerce data — Includes prices, discounts, benefit points, seller and brand information, delivery, ratings, and reviews.
• Seven sort options — Ranking, popularity, price ascending or descending, sales, reviews, and newest.
• Partial-result protection — Saves results page by page, so items stored before a later failure remain available.
• Cost-aware saving — Saves only the results allowed by the run cost limit and finishes successfully with Cost limit reached.

Quick start

{
    "searchKeywords": ["노트북"]
}

This input uses the documented defaults: up to 50 unique products per keyword, 11st ranking order, ads included, and a two-second request delay.

Pricing and platform usage

This Actor uses pay-per-event pricing:

• Result event: $2.90 per 1,000 saved products ($0.0029 per product)
• Actor start event: $0.00005 per run
• Apify platform usage: charged separately by Apify based on the resources used and the customer's subscription plan
• A zero-result run has no result-event charge, but the start event and platform usage may still apply

To cap total spending for a run:

• In Apify Console, open Run options → Maximum cost per run.
• When starting through the API, set the run option maxTotalChargeUsd.

The cost limit is a run option, not an Actor input field. When the limit is reached, the Actor preserves the allowed partial results and finishes successfully with a Cost limit reached status.

Input and seven sort options

Parameter	Type	Default	Description
searchKeywords	string[]	Required	Korean or English search terms. Each keyword is searched separately.
maxItemsPerKeyword	integer	50	Maximum unique products to save per keyword. Allowed range: 1–10,000. This is a request limit, not a guaranteed result count.
sortBy	string	"ranking"	One of the seven sort values below.
minPrice	integer	—	Minimum price in KRW.
maxPrice	integer	—	Maximum price in KRW.
excludeAds	boolean	false	Set to true to exclude products identified as ads.
requestDelay	number	2	Delay between requests in seconds. Allowed range: 1–10; the Actor enforces at least one second.
proxyConfiguration	object	No API default	Apify Console preselects automatic Apify Proxy. API and CLI callers must pass this field explicitly if they want to use a proxy.

Value	Sort order
ranking	11st ranking — default
popularity	Popularity
price_asc	Price: low to high
price_desc	Price: high to low
sales	Best selling
reviews	Most reviews
latest	Newest

Exact 29-field output

Every Dataset item contains exactly 29 keys. Fields unavailable in the 11st response can be null. Boolean indicators use their documented false fallback.

Group	Count	Fields
Product and source	7	productId, title, catalogId, productUrl, thumbnailUrl, searchKeyword, scrapedAt
Price and benefits	10	price, originalPrice, discountRate, directDiscountAmount, currency, isLowestPrice, is30DayLowest, isDeal, hasOptionPrice, benefitPoints
Ratings, brand, and seller	7	rating, ratingMax, reviewCount, brandName, isOfficialBrand, sellerBadgeType, sellerNickName
Listing, stock, and delivery	5	isSoldOut, isAd, listType, deliveryFee, deliveryETA
Total	29

deliveryFee and benefitPoints remain strings because the source can return text such as "무료", "3,000", or "20,170".

Results are stored in the default Dataset and can be accessed through the Dataset API or exported as JSON, CSV, or Excel.

Limitations and FAQ

Is 10,000 products per keyword guaranteed?

No. 10,000 is the largest value accepted by maxItemsPerKeyword. The actual saved count can be lower because of the available search results, duplicate removal, ad exclusion, the run cost limit, or request failures.

Does this Actor use a browser?

No. It sends HTTP requests to 11st's search JSON API. Playwright and browser rendering are not used.

Does it support Korean and English keywords?

Yes. Keywords are passed to 11st without language conversion. The relevance and number of results depend on 11st's current search index.

What happens when a request fails?

For 429, 5xx, and network errors, the Actor makes up to eight attempts with exponential backoff and jitter. If all attempts fail, the run fails. A non-429 4xx response stops only the affected keyword and continues with the next keyword. Because results are saved page by page, items stored before the failure remain in the Dataset.

What happens when the cost limit is reached?

The Actor saves only the items allowed by the remaining result-event budget and finishes successfully with a Cost limit reached status. If no result event can be charged before crawling begins, no product request is made.

Are ads included by default?

Yes. Every record contains isAd. Set excludeAds: true to remove identified ads before saving.

Does it scrape product detail pages?

No. This Actor collects product metadata available in 11st search results. It does not scrape full specifications, all product options, full reviews, downloadable image files, or sellers' personal contact information.

Python and Google Sheets integrations

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("ficuslink/11st-products-crawler").call(run_input={
    "searchKeywords": ["노트북", "운동화"],
    "maxItemsPerKeyword": 100,
    "sortBy": "price_asc",
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} - {item['price']} KRW")

Google Sheets

For recurring Google Sheets delivery, follow Apify's Make integration guide: Run an Actor → Get Dataset Items → Google Sheets Bulk Add Rows.

For manual downloads and Dataset API access, see the Apify Dataset documentation.

Disclaimer

This tool is intended for legitimate uses such as market research, price monitoring, and competitive analysis. Users are responsible for complying with applicable laws and 11st's Terms of Service. The Actor collects publicly visible product metadata and thumbnail URLs; it does not download images or collect sellers' personal contact information.

---

Korean

이용 대상과 제공 결과

11st Products Crawler는 한국의 온라인 마켓플레이스인 11번가의 상품 검색 결과를 구조화된 데이터로 수집합니다. 일정한 형식의 검색 결과 데이터가 필요한 가격 모니터링, 판매자 조사, 시장 분석, 데이터 처리 작업에 사용할 수 있습니다.

브라우저를 실행하지 않고 11번가 검색 JSON API에 직접 요청합니다. 저장되는 모든 상품은 동일한 29개 필드 구조를 가집니다.

핵심 특성

• 브라우저 미사용 — Playwright나 브라우저 렌더링 없이 JSON API에 직접 요청합니다.
• 29개 고정 필드 — 모든 Dataset 항목에 동일한 29개 키가 들어갑니다.
• 광고 처리 — isAd로 광고 여부를 표시하고 excludeAds로 광고 상품을 제외할 수 있습니다.
• 키워드별 중복 제거 — 각 키워드에서 여러 페이지에 반복되는 productId를 제거합니다.
• 상품 분석 정보 — 가격, 할인, 혜택 포인트, 판매자, 브랜드, 배송, 평점, 리뷰 정보를 제공합니다.
• 7가지 정렬 — 랭킹순, 인기순, 낮은 가격순, 높은 가격순, 누적 판매순, 리뷰순, 최신순을 지원합니다.
• 부분 결과 보존 — 페이지 단위로 결과를 저장하므로 이후 요청이 실패해도 먼저 저장된 상품은 남습니다.
• 비용 한도 적용 — 실행 비용 한도에서 허용되는 결과만 저장하고 Cost limit reached 상태로 정상 종료합니다.

최소 입력

{
    "searchKeywords": ["노트북"]
}

위 입력은 키워드당 최대 고유 상품 50개, 11번가 랭킹순, 광고 포함, 요청 간격 2초의 기본값을 사용합니다.

가격과 플랫폼 사용료

이 Actor는 이벤트 단위 과금 방식을 사용합니다.

• 결과 이벤트: 저장된 상품 1,000개당 $2.90(상품 1개당 $0.0029)
• Actor 시작 이벤트: 실행당 $0.00005
• Apify 플랫폼 사용료: 사용한 자원과 고객의 구독 플랜에 따라 Apify가 별도로 부과
• 결과가 0건이면 결과 이벤트 비용은 없지만 시작 이벤트와 플랫폼 사용료는 발생할 수 있음

실행의 총비용을 제한하려면 다음과 같이 설정합니다.

• Apify Console에서는 Run options → Maximum cost per run을 설정합니다.
• API로 실행할 때는 실행 옵션 maxTotalChargeUsd를 설정합니다.

비용 한도는 Actor 입력 필드가 아니라 실행 옵션입니다. 한도에 도달하면 허용된 부분 결과를 보존하고 Cost limit reached 상태로 정상 종료합니다.

입력과 7개 정렬값

입력값	타입	기본값	설명
searchKeywords	string[]	필수	한국어 또는 영어 검색어입니다. 각 키워드를 따로 검색합니다.
maxItemsPerKeyword	integer	50	키워드당 저장할 고유 상품의 상한입니다. 1~10,000을 입력할 수 있으며 실제 저장 수량을 보장하지 않습니다.
sortBy	string	"ranking"	아래 7개 정렬값 중 하나입니다.
minPrice	integer	없음	원 단위 최소 가격입니다.
maxPrice	integer	없음	원 단위 최대 가격입니다.
excludeAds	boolean	false	true로 설정하면 광고로 판별된 상품을 제외합니다.
requestDelay	number	2	요청 사이의 대기 시간(초)입니다. 1~10을 입력할 수 있으며 Actor는 최소 1초를 적용합니다.
proxyConfiguration	object	API 기본값 없음	Apify Console에서는 자동 Apify Proxy가 미리 선택됩니다. API나 CLI에서 프록시를 사용하려면 이 값을 명시해야 합니다.

값	정렬 방식
ranking	11번가 랭킹순 — 기본값
popularity	인기순
price_asc	낮은 가격순
price_desc	높은 가격순
sales	누적 판매순
reviews	많은 리뷰순
latest	최신순

정확히 29개인 출력

모든 Dataset 항목에는 정확히 29개 키가 들어갑니다. 11번가 응답에 값이 없는 필드는 null이 될 수 있으며, boolean 표시값은 문서에 설명된 대로 false를 기본값으로 사용합니다.

그룹	개수	필드
상품·출처	7	productId, title, catalogId, productUrl, thumbnailUrl, searchKeyword, scrapedAt
가격·혜택	10	price, originalPrice, discountRate, directDiscountAmount, currency, isLowestPrice, is30DayLowest, isDeal, hasOptionPrice, benefitPoints
평점·브랜드·판매자	7	rating, ratingMax, reviewCount, brandName, isOfficialBrand, sellerBadgeType, sellerNickName
노출·재고·배송	5	isSoldOut, isAd, listType, deliveryFee, deliveryETA
합계	29

deliveryFee와 benefitPoints는 원본 응답의 "무료", "3,000", "20,170" 같은 표현을 보존하기 위해 문자열로 제공합니다.

결과는 기본 Dataset에 저장되며 Dataset API로 조회하거나 JSON, CSV, Excel 형식으로 내보낼 수 있습니다.

제한사항과 FAQ

키워드당 10,000개 수집이 보장되나요?

아닙니다. 10,000은 maxItemsPerKeyword에 입력할 수 있는 최댓값입니다. 검색 가능한 상품 수, 중복 제거, 광고 제외, 실행 비용 한도, 요청 실패에 따라 실제 저장량은 더 적을 수 있습니다.

브라우저를 사용하나요?

아닙니다. 11번가 검색 JSON API에 HTTP 요청을 보냅니다. Playwright나 브라우저 렌더링은 사용하지 않습니다.

한국어와 영어 검색어를 모두 지원하나요?

네. 검색어를 언어 변환 없이 11번가에 전달합니다. 검색 결과의 관련성과 수량은 11번가의 현재 검색 색인에 따라 달라집니다.

요청이 실패하면 어떻게 처리하나요?

429, 5xx, 네트워크 오류는 지수 백오프와 지터를 적용해 최대 8회 시도합니다. 모든 시도가 실패하면 전체 실행을 실패로 처리합니다. 429가 아닌 4xx 응답은 해당 키워드만 중단하고 다음 키워드를 계속 처리합니다. 결과를 페이지 단위로 저장하므로 오류 전에 저장된 상품은 Dataset에 남습니다.

비용 한도에 도달하면 어떻게 되나요?

남은 결과 이벤트 예산으로 저장할 수 있는 상품만 저장하고 Cost limit reached 상태로 정상 종료합니다. 수집 시작 전부터 결과 이벤트를 과금할 여유가 없으면 상품 요청을 보내지 않습니다.

광고 상품이 기본으로 포함되나요?

네. 모든 결과에 isAd가 포함됩니다. 저장 전에 광고로 판별된 상품을 제외하려면 excludeAds: true를 설정합니다.

상품 상세 페이지도 수집하나요?

아닙니다. 이 Actor는 11번가 검색 결과에 포함된 상품 메타데이터를 수집합니다. 전체 상품 사양, 모든 옵션, 전체 리뷰, 이미지 파일, 판매자의 개인 연락처는 수집하지 않습니다.

Python·Google Sheets 연동

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("ficuslink/11st-products-crawler").call(run_input={
    "searchKeywords": ["노트북", "운동화"],
    "maxItemsPerKeyword": 100,
    "sortBy": "price_asc",
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} - {item['price']} KRW")

Google Sheets

Google Sheets에 결과를 정기적으로 전달하려면 Apify의 Make 연동 가이드를 따릅니다. 연결 순서는 Run an Actor → Get Dataset Items → Google Sheets Bulk Add Rows입니다.

결과를 직접 내려받거나 Dataset API로 조회하는 방법은 Apify Dataset 문서를 참고하십시오.

이용 범위 및 면책

이 도구는 시장 조사, 가격 모니터링, 경쟁 분석 등 적법한 용도를 위한 것입니다. 사용자는 관련 법률과 11번가 이용약관을 준수해야 합니다. Actor는 공개된 상품 메타데이터와 썸네일 URL만 수집하며 이미지 파일이나 판매자의 개인 연락처를 수집하지 않습니다.