웹 스크래핑이 사이트 화면을 직접 읽는 방식이라면, 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으로도 저장, 재사용 가능하게” |