API (Application Programming Interface)
서로 다른 프로그램이나 서비스가 서로 소통하고 데이터를 주고받을 수 있도록 만들어진 '약속된 연결 통로'입니다.
같은 말:웹 APIApplication Programming InterfaceREST APIJSON
🤔 혹시 이런 생각 해본 적 없나요?
- "GA4 데이터를 자동으로 스프레드시트로 가져올 수 없을까?"
- "메타 광고 데이터를 우리 대시보드에서 한 번에 볼 수 없을까?"
- "n8n이나 Zapier는 도대체 어떻게 여러 툴을 연결하는 걸까?"
이 모든 게 가능한 이유는 바로 API 덕분입니다.
🔑 API, 한마디로 뭘까요?
API(Application Programming Interface)는 서로 다른 프로그램이나 서비스가 서로 소통하고 데이터를 주고받을 수 있도록 만들어진 '약속된 연결 통로'입니다.
쉽게 말해, 여러분이 직접 프로그램 내부를 건드리지 않아도 정해진 방식으로 요청하면 원하는 기능이나 데이터를 받을 수 있게 해주는 중간 다리 역할을 합니다.
🍽️ 레스토랑의 메뉴판과 웨이터
"까르보나라 메뉴 정보를 알려주세요"
메뉴 정보를 조회해 결과를 준비합니다
"menu": "까르보나라",
"price": 15000,
"status": "완료"
}
이 예시는 메뉴 정보를 조회하는 요청입니다. 응답은 JSON 형식으로 표현했습니다.
레스토랑에서 음식을 주문할 때를 생각해보세요.
- 주방(서버): 실제 음식을 만드는 곳. 여러분은 들어갈 수 없습니다.
- 메뉴판(API 문서): 주문 가능한 음식 목록과 방법이 적혀있습니다.
- 웨이터(API): 여러분의 주문을 받아 주방에 전달하고, 완성된 음식을 가져다줍니다.
- 손님(사용자): 메뉴판을 보고 웨이터에게 주문합니다.
여러분은 주방에 직접 들어가지 않아도, 웨이터에게 "까르보나라 메뉴 정보를 알려주세요"라고 정확히 요청하면 메뉴 정보를 받을 수 있습니다. API도 마찬가지입니다. 정해진 방식으로 요청하고 사용 권한과 조건이 맞으면 데이터나 기능을 이용할 수 있습니다.
본문 개념을 설명하는 학습용 예시입니다. 실제 서비스 화면이 아닙니다.
📦 택배 주문 시스템
온라인 쇼핑몰에서 물건을 주문하는 과정도 API처럼 요청과 응답으로 이루어집니다.
- 여러분은 상품 번호와 배송지를 입력(요청)합니다.
- 쇼핑몰 시스템은 창고에서 물건을 찾아 포장(처리)합니다.
- 며칠 후 택배가 도착(응답)합니다.
여러분은 창고 내부를 볼 수 없지만, 정해진 양식으로 주문하면 원하는 물건을 받을 수 있습니다. API도 이렇게 요청(Request)과 응답(Response)으로 작동합니다.
⚙️ API는 어떤 종류가 있나요?
요청 방법과 주소를 함께 확인합니다. 위 예시에서 사용자 한 명의 교체와 삭제에는 /users/1을 예로 들었습니다.
API를 구분하는 기준은 여러 가지입니다. 먼저 누구에게 제공하는지를 보면 공개 API, 특정 파트너에게 제공하는 API, 조직 내부 API 등으로 나눌 수 있습니다. 공개 문서가 있다고 인증 없이 무료로 쓸 수 있다는 뜻은 아닙니다. 신청 조건과 권한, 이용 한도를 문서에서 확인합니다.
REST API는 공개 범위가 아니라 웹 API를 설계하는 방식을 설명하는 말입니다. 공개 API도 내부 API도 REST 방식으로 만들 수 있습니다. 요청 주소(엔드포인트, Endpoint)는 요청을 보낼 URL이고, HTTP 메서드는 GET처럼 어떤 요청을 하는지 나타내는 이름입니다.
그림의 메서드별 동작은 다음 절의 표에서 PATCH와 함께 정리합니다. 실제 요청 주소와 필요한 값, 동작은 해당 API 문서를 따릅니다. https://api.example.com/users는 가상 주소이며 그대로 접속하는 실습용 API가 아닙니다.
처음에는 기존 내용을 바꾸지 않는 조회 요청을 읽는 것부터 시작합니다. 프로그램이 기능을 제공하지 않거나 권한이 없으면 형식이 맞아도 요청이 거절될 수 있습니다.
🚦 REST API 기본 개념: 요청 주소, 메서드와 상태 코드 읽기
REST API는 메모나 사용자 같은 자원을 요청 주소로 가리키고, HTTP 메서드로 그 자원에 할 일을 정하도록 설계한 웹 API입니다. 모든 웹 API가 REST 방식은 아니며, 응답을 JSON으로 보낸다는 사실만으로 REST API가 되지도 않습니다. 이 절에서는 앞 절의 REST API를 요청 주소, 메서드, 상태 코드로 나눠 읽습니다.
REST API의 요청 주소는 자원의 위치를 나타냅니다. 아래는 구조를 읽기 위한 가상 요청 주소입니다.
GET /users 사용자 목록 조회
GET /users/123 123번 사용자 한 명 조회
POST /users 새 사용자 등록
GET /users/123/posts 123번 사용자의 게시글 목록 조회요청 주소의 /users는 사용자 묶음을, 뒤에 붙은 123은 그 묶음 안의 사용자 한 명을 가리킵니다. /users/123/posts는 123번 사용자에게 딸린 게시글 묶음입니다. 목록을 한 번에 몇 건까지 돌려주는지, 누가 조회할 수 있는지는 요청 주소가 아니라 API 문서가 정합니다.
앞의 그림에 없던 PATCH까지 더해 다섯 메서드를 정리하면 다음과 같습니다.
| 메서드 | 하는 일 |
|---|---|
| GET | 자원을 조회합니다 |
| POST | 새 자원을 만듭니다 |
| PUT | 자원 전체를 보낸 내용으로 교체합니다 |
| PATCH | 자원의 일부만 수정합니다 |
| DELETE | 자원을 삭제합니다 |
123번 사용자의 이메일만 바꾸는 경우를 예로 듭니다. PATCH 요청에는 바꿀 이메일 값만 담습니다. PUT 요청은 사용자 정보 전체를 교체하므로, 보낼 때 이름을 빠뜨리면 이름이 비워질 수 있습니다.
서버는 응답마다 처리 결과를 200, 404 같은 숫자인 HTTP 상태 코드로 알려 줍니다. 자동화 도구의 실행 기록이나 오류 화면에서 자주 보는 코드는 다음과 같습니다.
| 상태 코드 | 뜻 | 먼저 확인할 것 |
|---|---|---|
| 200 | 요청이 성공했습니다 | 응답 내용이 요청한 기간과 항목과 맞는지 |
| 201 | 새 자원이 만들어졌습니다 | 만들어진 자원의 ID |
| 204 | 성공했지만 응답 본문이 없습니다 | 비어 있는 본문을 JSON으로 읽으려 하지 않았는지 |
| 401 | 유효한 인증 정보가 없습니다 | API 키나 로그인 토큰 |
| 403 | 서버가 요청을 이해했지만 거부했습니다 | 계정의 권한 |
| 404 | 요청한 자원을 찾지 못했습니다 | 요청 주소와 ID |
| 429 | 정해진 시간 안에 요청을 너무 많이 보냈습니다 | API 문서의 요청 한도와 다시 보낼 시각 |
| 500 | 서버가 요청을 처리하다 문제가 생겼습니다 | 서비스 상태 안내와 오류 본문 |
상태 코드 숫자 하나로 원인을 확정하지 않습니다. 403은 권한 부족 때문일 수도 있고 서비스 정책 때문일 수도 있으므로 오류 본문과 API 문서를 함께 읽습니다. 웹페이지 코드에서 API 요청을 보내는 JavaScript 함수 fetch는 404나 500 응답을 받아도 오류를 내며 멈추지 않습니다. 코드가 응답의 status(상태 코드 숫자)나 ok(200번대 성공이면 true가 되는 값)를 직접 확인해야 실패를 알아챌 수 있습니다.
📄 JSON이란: API 응답을 담는 데이터 형식
JSON(JavaScript Object Notation)은 프로그램끼리 데이터를 주고받을 때 쓰는 텍스트 형식입니다. 앞의 레스토랑 예시에서 서버가 돌려준 응답도 JSON으로 적었습니다. 웹 API 문서의 응답 예시가 JSON으로 나오는 경우가 많으므로, API를 다루기 전에 JSON의 생김새를 읽을 수 있어야 합니다.
JSON은 데이터를 두 가지 구조로 묶습니다.
- 객체(Object): 중괄호
{ }안에 키와 값의 쌍을 담습니다. 키는 값에 붙인 이름표입니다."menu": "까르보나라"에서"menu"가 키이고"까르보나라"가 값입니다. - 배열(Array): 대괄호
[ ]안에 여러 값을 순서대로 담습니다. 배열 안의 순서 번호는 0부터 시작합니다.
값으로는 문자열, 숫자, 참과 거짓을 나타내는 true와 false, 값이 없음을 나타내는 null이 올 수 있습니다. 객체의 값으로 다른 객체나 배열을 넣어 여러 겹으로 쌓을 수도 있습니다. 아래는 가상 주문 집계 API의 응답 예시입니다.
{
"date": "2026-10-01",
"orders": 12,
"channels": ["검색", "광고"],
"store": { "name": "가상 상점", "open": true }
}이 응답에서 "orders"의 값 12는 따옴표가 없는 숫자입니다. "channels"의 값은 문자열 두 개를 담은 배열이고, 첫 번째 값 "검색"의 순서 번호는 0입니다. "store"의 값은 다시 객체이므로 상점 이름을 찾으려면 store 객체 안의 name 값을 읽습니다.
JSON은 웹페이지의 동작을 만드는 프로그래밍 언어 JavaScript의 객체 표기에서 나왔지만, 규칙은 더 엄격합니다.
| 규칙 | JavaScript 객체 | JSON |
|---|---|---|
| 키의 따옴표 | 생략할 수 있습니다 | 반드시 큰따옴표로 감쌉니다 |
| 문자열의 따옴표 | 작은따옴표도 쓸 수 있습니다 | 큰따옴표만 씁니다 |
| 마지막 항목 뒤 쉼표 | 허용합니다 | 허용하지 않습니다 |
| 주석 | 쓸 수 있습니다 | 쓸 수 없습니다 |
{ "name": "드립백", "price": 3000, }처럼 마지막 항목 뒤에 쉼표가 남으면 JSON을 읽는 프로그램이 문법 오류를 냅니다. 오류 문구는 프로그램마다 다르고, Unexpected token이 자주 보이는 예입니다. 이런 오류가 나면 큰따옴표와 마지막 쉼표를 먼저 봅니다. 서버가 JSON 대신 HTML 오류 페이지를 보내도 같은 오류가 날 수 있으므로, 실제로 받은 내용이 JSON인지도 함께 확인합니다.
웹 기초 연습 페이지의 두 번째 영역에서 가상 상품 JSON을 직접 검사해 볼 수 있습니다. 마지막 쉼표를 넣고 JSON 검사 버튼을 누르면 문법 오류가 나타납니다. 쉼표를 지우고 가격만 3000에서 3500으로 바꾸면 문법 검사는 통과하지만 원자료의 가격과 달라집니다. 문법 검사와 원자료 대조는 서로 다른 확인이라는 점을 이 연습에서 볼 수 있습니다.
💡 이걸 알면 마케터에게 뭐가 좋을까요?
1. 툴 간 자동화 연결이 가능합니다
- Zapier, Make, n8n 같은 자동화 도구는 모두 API를 사용합니다.
- "GA4에서 데이터 받아서 → 스프레드시트에 저장 → 슬랙 알림" 같은 워크플로우를 만들 수 있습니다.
- 반복 작업을 자동화하여 시간을 절약할 수 있습니다.
2. 광고 데이터를 효율적으로 관리할 수 있습니다
- Meta Ads API와 Google Ads API로 광고 성과 데이터를 자동으로 수집할 수 있습니다.
- 여러 플랫폼의 데이터를 한 곳에 모아 통합 대시보드를 만들 수 있습니다.
- 수동으로 다운로드하던 리포트를 자동화할 수 있습니다.
3. 개발자와 원활하게 소통할 수 있습니다
- "API로 GA4에 이벤트를 보내주세요"라고 구체적으로 요청할 수 있습니다.
- 어떤 데이터를 어떻게 연결해야 하는지 명확하게 전달할 수 있습니다.
- 기술 용어를 이해하면 프로젝트 협업이 훨씬 수월해집니다.
가상 보고서에서 요청과 응답 맞춰 보기
이번에는 코드를 실행하거나 계정을 연결하지 않고, 다음 가상 API 기록을 읽습니다. 무료 또는 유료 도구를 새로 신청할 필요가 없습니다.
요청: 10월 1일의 주문 수를 조회
응답: 날짜 10월 2일, 주문 수 12건, 응답 상태 성공응답 상태가 성공이어도 요청한 날짜와 다릅니다. 12건을 10월 1일 실적으로 복사하면 안 됩니다. 먼저 요청에 보낸 날짜와 시간대 조건을 확인하고, 다시 조회한 응답에도 그 날짜가 맞는지 대조합니다. 상태 성공은 요청 처리가 끝났다는 신호이며 업무상 정답을 보장하지 않습니다.
메모장에 요청한 항목, 받은 항목과 다른 점을 나눠 적어 보세요. 원하는 결과는 "10월 1일 주문 수, 날짜와 집계 기준 확인 완료"처럼 확인된 범위를 설명할 수 있는 기록입니다. 값이 없으면 0건이라고 채우지 말고 응답에서 빠진 이유를 먼저 확인합니다.
이번에는 응답을 "접근 권한 없음"으로 바꿔 생각해 봅니다. 같은 요청을 반복하기보다 사용할 계정과 필요한 권한을 확인해야 합니다. 오류 내용과 발생 시각, 요청한 항목을 남기되 비밀번호나 API 키는 도움 요청에 붙이지 않습니다. API 키는 요청자를 식별하거나 권한을 확인하는 비밀값입니다.
실제 자동화는 조회 결과 한 건이 맞는지 확인한 뒤 저장 단계로 확장합니다. GA4의 집계 보고서를 읽는 작업과 원시 이벤트 전체를 내보내는 작업은 다르므로 필요한 데이터부터 구분합니다. 자동화 도구의 연결 기능과 사용량 조건도 그때 확인하면 됩니다.
📋 3줄 요약
-
API는 서로 다른 프로그램이 정해진 형식으로 데이터를 주고받도록 만든 약속된 연결 통로입니다.
-
웹 API에서는 요청 주소와 방법, 필요한 입력을 문서에서 확인하고 응답의 기간과 항목이 요청과 맞는지 대조합니다.
-
자동화 도구도 API 연결을 활용하지만 접근 권한과 비용, 오류 처리를 확인하고 결과가 저장됐는지 검증해야 합니다.
참고 자료
웹 API 개념은 MDN 문서를 2026년 10월 3일, REST 메서드와 상태 코드는 2026년 10월 24일 확인했습니다. 보고서 요청과 응답은 학습용 가상 예제입니다.

제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
GA4 집계 보고서를 정기적으로 시트에 옮기려 합니다. 연결 권한과 지원 항목을 확인한 뒤 시도할 방법은 무엇인가요?
예제나 확인 질문을 직접 시도한 뒤 완료 표시해요. 더 연습할 내용이 남으면 표시하지 않고 다음 글을 읽어도 됩니다. 완료 버튼은 이해도를 채점하지 않으며 잘못 표시하면 취소할 수 있어요.

