웹 스크래핑이 사이트 화면을 직접 읽는 방식이라면, API는 플랫폼이 공식으로 데이터를 제공하는 창구입니다. 더 안정적이고 빠르며, AI와 함께하면 코드를 직접 몰라도 데이터를 가져올 수 있습니다.

⚠️ 이 챕터는 11번가 판매자(셀러) 계정이 있어야 실습할 수 있습니다.
API 키는 강사가 별도 제공합니다.


4-2-1. API란 무엇인가 (10분)

API(Application Programming Interface)란 두 프로그램이 서로 데이터를 주고받는 규칙입니다. 쉽게 말해 플랫폼이 준비해 둔 “데이터 주문 창구”입니다.

개념 일상 비유 실제 예시
API 엔드포인트 주문 창구 주소 https://soffice.11st.co.kr/escrow/SaleEndList.tmall
요청(Request) 주문서 작성 상품번호, 날짜 범위 등 파라미터 전달
응답(Response) 음식 수령 JSON/XML 형식으로 데이터 반환
API KEY 회원 카드 본인 확인용 인증 키 (헤더에 포함)

스크래핑 vs API 비교

항목 웹 스크래핑 API
안정성 사이트 디자인 바뀌면 깨짐 ✅ 구조 변경 없음
속도 느림 (브라우저 실행) ✅ 빠름 (데이터만 요청)
접근 누구나 시도 가능 API KEY 필요
데이터 품질 파싱 오류 가능 ✅ 정형화된 데이터

4-2-2. 11번가 셀러오피스 API 살펴보기 (15분)

11번가 셀러오피스는 판매 완료 내역, 정산 현황 등을 API로 조회할 수 있습니다. 아래 표에서 주요 엔드포인트와 파라미터를 확인합니다.

📋 프롬프트 (Cursor — API 문서 분석)

아래는 11번가 셀러오피스 API 문서야.
어떤 기능을 제공하는지, 각 API의 URL·파라미터·응답 형식을 표로 정리해줘.
[API 문서 붙여넣기]

주요 API 엔드포인트

기능 메서드 엔드포인트
판매완료 내역 조회 POST /escrow/SaleEndList.tmall?method=getSellAjaxList
정산현황 요약 GET /remittance/...?method=getSellerOwnSelStatSoffice
정산 상세 목록 POST /remittance/...?method=getSelAllStatDtlsSoffice

판매완료 내역 주요 파라미터

파라미터 설명 예시
shDateFrom 조회 시작일 2026/03/01
shDateTo 조회 종료일 2026/03/11
shDateType 날짜 기준 03 (구매확정일)
start 페이징 시작 인덱스 0
limit 한 페이지 건수 30

응답 데이터 주요 필드

필드명 설명 예시
ORD_NO_VIEW 주문번호 20260220043162314
ORD_DT 주문일시 2026/02/20 13:59
PRD_NM 상품명 대천김 곱창김 20g×10매
ORD_QTY 수량 1
SEL_PRC 판매가 22000
SEL_FEE_AMT 정산예정금액 19360
SEL_FIXED_FEE 수수료율 12.00(%)
ORD_PRD_STAT 주문상태 확정

4-2-3. API KEY 안전하게 관리하기 (5분)

API KEY는 절대 코드에 직접 입력하지 마세요. 실수로 공유하면 악용될 수 있습니다. .env 파일에 별도 보관하는 것이 표준 방식입니다.

📋 프롬프트 (Cursor)

API KEY를 코드에 직접 넣지 않고 안전하게 관리하는 방법으로 바꿔줘.
.env 파일과 python-dotenv를 사용하는 방식으로 적용해줘.

.env 파일 양식:

# .env 파일 (프로젝트 폴더에 저장, 절대 공유 금지!)
ST11_API_KEY=여기에_강사_제공_키_입력
ST11_ID=내_아이디

코드에서 불러오는 방법:

from dotenv import load_dotenv
import os

load_dotenv()
api_key = os.getenv("ST11_API_KEY")  # 환경변수에서 키 읽기

💡 주의사항:

  • .env 파일은 .gitignore에 반드시 추가 (GitHub 업로드 방지)
  • 다른 사람에게 파일 자체를 공유하지 않기

4-2-4. Cursor로 API 호출 스크립트 만들기 (20분)

API 문서를 이해했으면, Cursor에게 스크립트 생성을 맡깁니다. 프롬프트 한 줄로 인증부터 데이터 수집까지 자동 생성됩니다.

Step 1. 환경 설정

📋 프롬프트

11번가 셀러오피스 API를 Python으로 호출하는 환경을 만들어줘.
필요한 패키지를 설치하고, .env에서 API KEY를 읽어오는 기본 구조로 만들어줘.

Step 2. 판매 완료 내역 수집

📋 프롬프트

11번가 셀러오피스에서 최근 7일간 판매완료 내역을 가져오는 스크립트를 만들어줘.
openapikey 헤더에 API KEY를 넣고, POST 방식으로 요청해줘.
응답에서 completelist 배열을 꺼내서 출력해줘.

실행 결과 예시:

[1/3] API 인증 중...  → API KEY 확인 완료
[2/3] 판매완료 내역 조회 중...
  → 조회 기간: 2026/03/04 ~ 2026/03/11
  → 총 4건 수집
[3/3] 데이터 출력 중...
  주문번호: 20260220043162314
  상품명: 대천김 곱창김 20g×10매
  판매가: 22,000원 / 정산예정: 19,360원 (수수료 12%)
✅ 완료!

Step 3. 에러 발생 시

📋 프롬프트

API 응답에서 데이터가 0건으로 나와. 실제 응답 JSON을 출력해서 키 이름을 확인해줘.
[에러 메시지 붙여넣기]

💡 Tip: 11번가 API는 응답 키가 list가 아닌 completelist입니다. AI에게 실제 응답을 보여주면 자동으로 수정합니다.


4-2-5. 수집 데이터 저장 — CSV & JSON (10분)

수집한 데이터를 파일로 저장하면 나중에 엑셀 분석, 보고서 생성, 다른 스크립트 재활용이 가능합니다.

📋 프롬프트

수집된 판매내역을 CSV와 JSON 두 가지 형식으로 저장해줘.
파일명에 오늘 날짜를 포함하고, CSV는 엑셀에서 한글이 깨지지 않게 utf-8-sig로 저장해줘.

AI가 생성하는 저장 코드:

import csv, json
from datetime import datetime

today = datetime.now().strftime('%Y-%m-%d')

# CSV 저장
with open(f'11st_sales_{today}.csv', 'w', newline='', encoding='utf-8-sig') as f:
    keys = ['ORD_NO_VIEW', 'ORD_DT', 'PRD_NM', 'ORD_QTY', 'SEL_PRC', 'SEL_FEE_AMT', 'ORD_PRD_STAT']
    writer = csv.DictWriter(f, fieldnames=keys, extrasaction='ignore')
    writer.writeheader()
    writer.writerows(sales_data)

# JSON 저장
with open(f'11st_sales_{today}.json', 'w', encoding='utf-8') as f:
    json.dump(sales_data, f, ensure_ascii=False, indent=2)

print(f"✅ CSV: 11st_sales_{today}.csv ({len(sales_data)}건)")
print(f"✅ JSON: 11st_sales_{today}.json")
형식 용도 특징
CSV 엑셀 열기, 간단한 분석 utf-8-sig 인코딩으로 한글 정상 표시
JSON 다른 스크립트에서 재사용, API 연동 구조가 유지되어 재처리에 유리

4-2-6. 다른 판매 플랫폼 적용 (5분)

11번가 방식을 익히면 다른 플랫폼에도 동일한 흐름으로 적용할 수 있습니다.

플랫폼 API 접근 방식 특이사항
쿠팡 API KEY + 서명 인증 쿠팡 Wing 판매자 전용
스마트스토어 네이버 커머스 API OAuth 2.0 인증
G마켓/옥션 ESM Plus API 판매자 등록 필요

💡 Tip: 외부 API를 지원하는 쇼핑몰 전체 목록은 아래에서 확인할 수 있습니다.

📋 범용 프롬프트 패턴

[플랫폼명] 판매내역 API를 Python으로 호출해줘.
API KEY는 .env 파일에서 읽어오고,
[시작일]부터 [종료일]까지 판매완료 내역을 수집해서
CSV와 JSON으로 저장해줘.

📋 핵심 요약

상황 도구 프롬프트 핵심
API 문서 이해 Cursor “이 API 문서를 분석해서 기능과 파라미터를 표로 정리해줘”
API KEY 안전 보관 .env + python-dotenv “API KEY를 .env 파일에서 읽어오도록 바꿔줘”
데이터 수집 스크립트 Python + requests “[API 엔드포인트]로 [기간] 데이터를 수집하는 스크립트 만들어줘”
CSV 저장 csv 모듈 “utf-8-sig 인코딩으로 CSV 저장, 파일명에 날짜 포함”
JSON 저장 json 모듈 “수집 결과를 JSON으로도 저장, 재사용 가능하게”