API

11번가 API: 판매가와 즉시할인가, 옵션 재고, 리뷰를 JSON으로

검색 결과, 상품 페이지, 구매 리뷰, 베스트 순위. 11번가에서 비회원에게 열려 있는 이 네 화면을 JSON 응답으로 바꿔 줍니다. 가격은 원화이고 판매가(`sell_price`)와 즉시할인이 반영된 화면 가격(`final_price`)이 따로 옵니다. 11번가 가격 변동을 기록하거나 가격 추적을 한다면 비교 기준은 `final_price`입니다. 셀러오피스와 연결해 상품을 올리고 주문을 처리하려는 판매자라면 이 API의 대상이 아닙니다. 읽기 전용이라 11번가 쪽에는 아무것도 기록하지 않습니다.

엔드포인트

endpoint무엇이 반환되는가필수
search한글이나 영문 키워드로 검색합니다. 광고 상품은 일반 결과와 섞지 않고 `ads`로 따로 돌려줍니다. 행마다 상품번호, 판매가와 할인가, 할인율, 판매자와 스토어, 배송비, 오늘출발 여부와 주문 마감 시각, 평점·리뷰 수·판매 수, '11번가 최저가' 같은 라벨이 들어 있습니다. 정렬 7가지(랭킹순·인기순·낮은 가격순·높은 가격순·누적 판매순·리뷰 많은순·최신순), 가격대, 무료배송, 공식·백화점몰, 중고·해외직구, 대분류 카테고리로 좁힐 수 있고 24페이지까지 내려갑니다.query
product상품 한 건 전체: 판매가, 판매자 즉시할인과 11번가 즉시할인, 쿠폰이 실제로 가격을 낮출 때만 채워지는 쿠폰가, 할인혜택가와 그 내역, 옵션별 재고와 품절 여부, 전체 재고, 구매 수량 제한, 평점·리뷰·문의·좋아요 수, 판매자 만족도와 응답률, 택배사·배송비·도착 예정일과 제주·도서산간 추가 배송비. 상품번호 또는 상품 주소(URL)를 넣으면 됩니다.product_id
reviews구매 리뷰, 페이지당 10개: 별점, 본문, 작성일, 작성자 닉네임(대부분 11번가가 일부를 *로 가린 형태), 구매한 옵션, 도움돼요 수, 사용성·성능 같은 항목별 평가, 사진·동영상 여부. 추천순·최신순, 긍정(4-5점)·부정(1-3점) 별점, 포토·동영상 리뷰만 보기를 지원하고 긍정·부정 개수도 함께 돌려줍니다.product_id
ranking11번가 베스트 500의 상위 40위. 전체, 14개 카테고리 그룹(뷰티, 디지털/가전, 신선식품 등), 그룹 안의 세부 카테고리, 남성·여성 쇼핑객별로 볼 수 있습니다. 행마다 순위, 상품번호, 취소선 가격(상품 페이지의 판매가와 같은 값)과 판매가, 할인율, 무료배송 여부, 판매자, 좋아요 수.모두 선택

호출마다 크레딧이 차감됩니다. 실패하거나 차단된 호출은 무료입니다.

동작하는 예제

판매가 369,000원에서 11번가 즉시할인(`instant_discount_11st`) 47,970원을 뺀 321,030원이 화면 가격이고, 판매자 즉시할인(`instant_discount_seller`)은 0원이었습니다. 할인이 어느 쪽에서 나왔는지 구분하려면 두 필드를 따로 저장하세요. 리뷰 수도 보는 곳마다 다릅니다. 같은 시각 검색 카드에는 1,026개, 상품 페이지에는 903개였고, 상품의 `review_count`는 `reviews` 호출의 total(903)과 일치합니다.

요청
curl -X POST https://api.reefapi.com/11st/v1/product \
  -H "x-api-key: 발급받은_API_키" \
  -H "content-type: application/json" \
  -d '{"product_id": "8653407353"}'
응답 (요약)
{
  "ok": true,
  "data": {
    "product": {
      "product_id": "8653407353",
      "title": "에어팟 프로 3 블루투스 이어폰 MFHP4KH/A",
      "brand": "Apple",
      "category": "음향가전>이어폰>무선 이어폰",
      "market_type": "RETAIL",
      "sell_price": 369000,
      "final_price": 321030,
      "discount_percent": 13,
      "instant_discount_seller": 0,
      "instant_discount_11st": 47970,
      "instant_discount_name": "Apple+즉시할인+13%",
      "coupon_price": null,
      "currency": "KRW",
      "stock_qty": 234,
      "purchase_limits": ["30일동안 최대구매수량 1개"],
      "rating": 4.8,
      "satisfied_pct": 100,
      "review_count": 903,
      "qna_count": 279,
      "seller": {
        "name": "Apple공식브랜드관",
        "satisfaction_pct": 97,
        "response_rate_pct": 100,
        ...
      },
      "delivery": {
        "courier": "한진택배",
        "fee": 0,
        "free": true,
        "arrival_text": "내일 10/26(월) 도착 예정",
        "order_cutoff_text": "・ 24:00 주문 시",
        "jeju_extra_fee": 3000,
        "island_extra_fee": 5000
      },
      "options": [
        {
          "level": 1,
          "name": "타입",
          "options": [{ "name": "AirPods Pro 3", "sold_out": false, "sell_price": 369000, "final_price": 321030, ... }]
        }
      ],
      "max_benefit_price": null,
      ...
    }
  },
  "meta": { "record_count": 1, "upstream_requests": 3, "cache_hit": false, "mode": "live" }
}

11번가 크롤링을 직접 짤 때 조용히 틀리는 곳

11번가 상품 페이지에는 '쿠폰보기' 버튼만 있고 실제로 깎아 주는 금액은 없는 쿠폰 블록이 자주 붙습니다. 이 블록의 쿠폰 적용가는 판매가를 그대로 되풀이하고 할인액은 0입니다. 저희 첫 실측에서 서로 다른 상품 10개 중 7개가 이 때문에 '쿠폰가 = 판매가'로 기록됐고, 그 뒤로는 쿠폰 할인액이 0보다 클 때만 `coupon_price`를 채웁니다. 고친 다음 실측에서는 11개 모두 null이었습니다.

Apple 공식관이나 슈팅배송처럼 11번가가 직접 파는 상품은 배송 정보가 일반 판매자 상품과 다른 블록에 들어 있습니다. 한쪽 블록만 읽는 파서는 이런 상품의 배송비와 도착 예정일을 빈 값으로 저장하게 되고, 저희도 첫 실측에서 그렇게 나와 두 블록을 모두 읽도록 고쳤습니다.

11번가 검색 결과는 24페이지에서 끝납니다. 25페이지 이상을 요청하면 11번가는 오류 없이 24페이지 내용을 그대로 다시 보여 줍니다. 다음 페이지를 계속 넘기도록 짠 수집기라면 24페이지 상품이 몇 번이고 중복 저장됩니다. 이 API는 25 이상을 INVALID_PARAM으로 거절합니다. 필터도 비슷해서, 11번가 검색은 모르는 정렬 코드나 혜택 값을 받아도 오류 없이 무시합니다. 그래서 공개한 필터는 모두 필터 없는 같은 검색어의 총개수와 맞대어 실제로 줄어든 것만 남겼습니다. 예를 들어 운동화 2,232,130건이 무료배송에서는 1,557,478건, 공식·백화점몰에서는 2,063건이었습니다.

11번가 가격 변동 그래프는 하루치 값 하나만 틀려도 그날 가격이 오르내린 것처럼 그려집니다. 쿠폰가가 판매가로 찍히거나 배송비가 빈 값으로 들어간 날이 섞이면, 실제 할인 행사와 파서 오류를 나중에 가려내기가 어렵습니다.

제한과 솔직한 메모

  • 이 API는 11번가가 운영하는 것이 아니고, 11번가와의 제휴나 계약 없이 공개 화면만 읽습니다.
  • 11번가플러스·T멤버십 같은 회원 가격과 카드사 조건부 할인가는 로그인한 구매자에게만 보이므로 돌려주지 않습니다.
  • 결과가 한 페이지에 다 들어오는 검색에서도 `has_more`가 true, `last_page`가 24로 나옵니다. 2026년 10월 25일 무료배송·낮은 가격순 '에어팟 프로 3'(total 71, 71행)에서 page 2를 요청하자 빈 목록 대신 SCHEMA_DRIFT 오류가 돌아왔습니다(과금되지 않음). 받은 행 수가 `total`과 같으면 다음 페이지를 부르지 마세요.
  • 낮은 가격순에는 중고 상품도 섞입니다. 같은 측정에서 상위 5행이 모두 '중고' 라벨이 붙은 S급·S+급 중고 제품이었고, 새 제품은 6번째 행(303,400원)부터 나왔습니다. 새 상품끼리만 비교하려면 `labels`를 확인하세요.
  • 가격대 필터는 11번가가 자기 기준의 할인가로 적용하기 때문에, 화면 가격이 범위를 조금 벗어난 행이 섞일 수 있습니다(측정: 79행 중 1행, 상한 50,000원에 50,830원).
  • 베스트 순위는 상위 40위까지입니다. 41위부터 500위는 페이지의 추가 로딩 요청이 빈 응답을 돌려줘서 가져오지 못합니다.
  • 브랜드 필터는 없습니다. 측정한 검색어(nike, 운동화)의 필터 목록에 브랜드 항목이 나타나지 않았습니다. 판매자 사업자 정보 탭도 제공하지 않습니다.