22.Python requests 완벽 가이드 — VS Code에서 HTTP 요청 보내기부터 API 활용까지

저도 처음에는 필요한 정보를 얻기 위해 웹사이트를 이리저리 드나들며 마우스로 직접 긁어다 엑셀에 붙여넣곤 했습니다. 수작업으로 수십 페이지를 복사하다 보면 손목도 아프고 시간도 금방 지나갔죠. 하지만 파이썬의 requests 라이브러리를 알게 된 후로는 웹 데이터를 가져오거나 API를 호출하는 모든 과정이 자동화되었습니다. 예전에는 한 시간씩 걸리던 단순 반복 작업이, 이제는 코드 실행 한 번으로 단 1초 만에 끝나면서 업무 효율이 몰라보게 달라졌습니다


Python requests는 VS Code 환경에서 웹 서버와 데이터를 주고받을 때 가장 많이 사용하는 라이브러리입니다. 웹 크롤링, REST API 호출, 자동 로그인, 파일 다운로드 등 다양한 자동화 프로젝트의 시작점이라고 할 수 있습니다.

이번 글에서는 requests 라이브러리의 개념부터 설치 방법, GET과 POST 요청, JSON 데이터 처리, 파일 다운로드, 오류 처리까지 초보자도 쉽게 이해할 수 있도록 단계적으로 설명하겠습니다.

Python requests란 무엇인가

requests 라이브러리의 역할

Python requests는 인터넷을 통해 다른 서버와 데이터를 주고받을 수 있도록 도와주는 라이브러리입니다.

쉽게 비유하면 requests는 인터넷 세상의 택배 기사와 같습니다. 내가 원하는 주소(API)에 요청을 보내면 필요한 데이터를 받아 다시 나에게 전달해 줍니다.

또 다른 비유를 하자면, 웹 브라우저가 식당에서 메뉴를 주문하는 손님이라면 requests는 주문을 대신 전달하고 음식을 가져오는 직원과 같습니다.

웹사이트를 직접 열지 않아도 프로그램이 대신 요청을 보내고 결과를 받아올 수 있다는 점이 가장 큰 장점입니다.

대표적인 활용 분야는 다음과 같습니다.

  • REST API 호출
  • 웹 크롤링
  • 챗봇 개발
  • 자동 로그인
  • 파일 다운로드
  • 날씨, 환율, 주식 정보 조회

VS Code에서 Python requests 설치하기

requests 설치

VS Code 터미널에서 아래 명령어를 실행합니다.

pip install requests

설치가 완료되었는지 확인하려면 다음 코드를 실행합니다.

import requests

print(requests.__version__)

버전 정보가 출력되면 정상적으로 설치된 것입니다.


Python requests GET 요청 사용법

가장 기본적인 GET 요청

GET 요청은 서버에서 정보를 가져올 때 사용하는 가장 기본적인 방식입니다.

import requests

url = "https://jsonplaceholder.typicode.com/posts/1"

response = requests.get(url)

print(response.status_code)
print(response.text)

위 코드는 테스트용 API에서 데이터를 받아옵니다.

실행 결과는 JSON 형태의 데이터가 출력됩니다.

200

{
    ...
}

여기서 200은 요청이 정상적으로 처리되었다는 의미입니다.


JSON 데이터 처리하기

실무에서는 대부분 JSON 형태의 데이터를 사용합니다.

import requests

url = "https://jsonplaceholder.typicode.com/posts/1"

response = requests.get(url)

data = response.json()

print(data["title"])
print(data["body"])

.json() 메서드를 사용하면 JSON 데이터를 Python의 딕셔너리 형태로 바로 사용할 수 있습니다.

URL 파라미터 전달하기

검색 조건이나 페이지 번호를 전달할 때는 params 옵션을 사용합니다.

import requests

url = "https://jsonplaceholder.typicode.com/comments"

params = {
    "postId": 1
}

response = requests.get(url, params=params)

print(response.url)
print(response.json())

params를 사용하면 URL을 직접 이어 붙이지 않아도 안전하게 요청을 보낼 수 있습니다.

Python requests POST 요청 사용하기

POST 요청이 필요한 이유

GET이 정보를 가져오는 방식이라면 POST는 데이터를 서버에 전달하는 방식입니다.

회원가입, 로그인, 게시글 작성 등이 대표적인 예입니다.

import requests

url = "https://jsonplaceholder.typicode.com/posts"

payload = {
    "title": "Python",
    "body": "Requests Example",
    "userId": 1
}

response = requests.post(
    url,
    json=payload
)

print(response.status_code)
print(response.json())

POST 요청에서는 json= 옵션을 사용하는 것이 가장 일반적입니다.


Python requests로 파일 다운로드하기

이미지 다운로드

requests는 파일 다운로드에도 자주 사용됩니다.

import requests

url = "https://example.com/image.jpg"

response = requests.get(url)

with open("image.jpg", "wb") as file:
    file.write(response.content)

print("다운로드 완료")

텍스트는 response.text를 사용하지만 이미지나 PDF처럼 바이너리 파일은 response.content를 사용합니다.

PDF 다운로드

import requests

url = "https://pdfobject.com/pdf/sample.pdf"

response = requests.get(url)

with open("report.pdf", "wb") as file:
    file.write(response.content)

이 방식을 활용하면 자동 보고서 다운로드 시스템도 쉽게 만들 수 있습니다.


Python requests 실무 활용 사례

API 데이터 수집

공공데이터 API나 날씨 API를 호출하여 데이터를 자동으로 수집할 수 있습니다.

웹 크롤링

BeautifulSoup과 함께 사용하면 웹페이지 내용을 자동으로 분석할 수 있습니다.

텔레그램 알림

requests를 이용하면 텔레그램 Bot API를 호출하여 자동 알림을 전송할 수 있습니다.

OpenAI API 호출

OpenAI API 역시 HTTP 요청 기반으로 동작하므로 requests 라이브러리로 사용할 수 있습니다.

Python requests에서 자주 발생하는 오류

ModuleNotFoundError

원인

라이브러리가 설치되지 않은 경우입니다.

해결 방법

pip install requests

ConnectionError

원인

인터넷 연결이 없거나 서버가 응답하지 않는 경우입니다.

import requests

try:
    requests.get("https://example.com")
except requests.exceptions.ConnectionError:
    print("연결 실패")

Timeout 오류

응답이 오래 걸리는 경우 timeout을 지정하는 것이 좋습니다.

response = requests.get(
    url,
    timeout=5
)

시간이 지나도 응답이 없으면 자동으로 예외가 발생합니다.

상태 코드 확인하기

print(response.status_code)

대표적인 상태 코드는 다음과 같습니다.

  • 200 : 정상 처리
  • 201 : 생성 완료
  • 400 : 잘못된 요청
  • 401 : 인증 실패
  • 404 : 페이지 없음
  • 500 : 서버 오류

Python requests를 더 잘 활용하는 방법

requests는 단독으로 사용해도 강력하지만 다른 라이브러리와 함께 사용하면 더욱 강력해집니다.

추천 조합은 다음과 같습니다.

  1. requests + BeautifulSoup → 웹 크롤링
  2. requests + pandas → API 데이터 분석
  3. requests + Telegram Bot → 알림 자동화
  4. requests + FastAPI → 서버 개발
  5. requests + OpenAI API → AI 서비스 개발

이러한 조합은 실제 업무 자동화 프로젝트에서도 매우 자주 활용됩니다.

마무리

Python requests는 웹과 프로그램을 연결해 주는 가장 중요한 라이브러리 중 하나입니다. VS Code 환경에서 requests를 익혀두면 단순한 HTTP 요청을 넘어 API 연동, 데이터 수집, 자동화 시스템 구축까지 다양한 프로젝트를 구현할 수 있습니다.

처음에는 GET과 POST 요청만 익혀도 충분합니다. 이후 JSON 처리와 오류 처리, 파일 다운로드까지 차근차근 학습하면 대부분의 웹 기반 자동화 프로젝트를 직접 구현할 수 있습니다.

핵심 요약

  • requests는 HTTP 요청을 가장 쉽게 처리하는 Python 라이브러리입니다.
  • GET 요청은 데이터 조회에 사용합니다.
  • POST 요청은 데이터를 서버로 전송할 때 사용합니다.
  • JSON 데이터는 .json() 메서드로 쉽게 처리할 수 있습니다.
  • response.content는 파일 다운로드에 사용합니다.
  • timeout과 예외 처리를 함께 사용하면 안정적인 프로그램을 만들 수 있습니다.
  • requests는 웹 크롤링, API 연동, AI 서비스 개발 등 다양한 분야의 기본 도구입니다.



댓글

댓글 쓰기

이 블로그의 인기 게시물

1.Python 설치부터 실행까지 10분 만에 끝내기 — 초보자도 바로 따라 하는 완벽 가이드

이미지
프로그래밍을 처음 시작하기로 결심한 날, 많은 분들이 유튜브를 켜고 이렇게 검색합니다. "파이썬 설치 방법." 영상을 따라가다 보면 어느 순간 화면 속 강사의 컴퓨터와 내 컴퓨터가 달라지기 시작합니다. "명령어를 찾을 수 없습니다", "PATH가 설정되지 않았습니다" 같은 오류 메시지가 등장하고, 결국 설치도 못 한 채 탭을 닫아버리게 됩니다. 이 글은 바로 그 지점을 해결하기 위해 쓰였습니다. 설치 과정에서 실제로 막히는 이유, 놓치기 쉬운 체크박스 한 칸의 의미, 그리고 첫 코드를 실행하는 순간까지 — 군더더기 없이 안내해 드리겠습니다. 저도 처음 설치때 1시간을 소비 했습니다.이제 해매지 마세요~!!  Python이 실제로 하는 일 — 번역가 비유로 이해하기 Python을 설치하기 전에, Python이 무엇인지 정확히 이해하면 이후 과정이 훨씬 자연스러워집니다. 컴퓨터는 본래 0과 1, 즉 기계어만 이해합니다. 사람이 "파일을 열어줘"라고 말해도 컴퓨터는 알아듣지 못합니다. Python은 바로 이 간극을 메우는 번역가 역할을 합니다. 우리가 사람에게 말하듯 작성한 코드를 컴퓨터가 이해할 수 있는 언어로 변환해 주는 것입니다. 여기서 핵심이 있습니다. 번역가가 없으면 대화가 불가능합니다. Python을 설치한다는 것은 곧 이 번역가를 내 컴퓨터에 고용하는 일입니다. 설치가 완료된 순간부터 여러분의 컴퓨터는 Python이라는 언어를 이해하기 시작합니다. Python을 선택해야 하는 이유 문법이 자연어에 가깝습니다 — if 날씨 == "맑음": 나가기() 처럼, 코드가 한국어 문장 구조와 유사합니다. 범용성이 압도적입니다 — 데이터 분석, 웹 개발, 자동화, AI 모델 구축까지 하나의 언어로 가능합니다. 생태계가 방대합니다 — 전 세계 개발자들이 만든 50만 개 이상의 라이브러리가 무료로 제공됩니다. 취업 시장에서 가장 수요가 높습니다 ...
자세한 내용 보기

30.Python pyautogui로 마우스와 키보드 자동화하기: VSCode 실전 가이드

이미지
 저도 처음에 PATH에서 막혔는데, 매일 반복되는 사내 시스템 클릭 작업을 자동화해보려고 pyautogui 를 설치했지만 VSCode에서 실행할 때마다 "No module named 'pyautogui'"라는 오류만 계속 나왔던 기억이 있습니다. 분명 터미널에서는 설치가 잘 됐다고 나왔는데, 알고 보니 VSCode가 바라보고 있던 Python 인터프리터 경로와 제가 패키지를 설치한 경로가 서로 달랐던 것이 원인이었습니다. 인터프리터를 올바르게 맞춰주고 나서야 마우스가 제 손을 대신해 화면을 클릭하고 키보드를 두드리는 신기한 광경을 볼 수 있었습니다. 이번 글에서는 그때의 시행착오를 바탕으로, VSCode 환경에서 Python pyautogui를 활용해 마우스와 키보드를 자동화하는 방법을 정리해보려 합니다. pyautogui란 무엇인가 마우스와 키보드를 코드로 제어하는 라이브러리 pyautogui 는 Python 코드로 마우스 움직임과 클릭, 키보드 입력을 프로그래밍적으로 제어할 수 있게 해주는 GUI 자동화 라이브러리입니다. 웹 브라우저나 애플리케이션 내부 요소를 직접 다루는 Selenium과 달리, pyautogui는 화면 좌표와 픽셀을 기준으로 동작하기 때문에 특정 프로그램에 국한되지 않고 컴퓨터 화면에서 벌어지는 거의 모든 작업을 자동화할 수 있습니다. 비유하자면 pyautogui는 마치 컴퓨터 앞에 보이지 않는 손 하나를 앉혀두는 것과 같습니다. 이 손은 사람이 시키는 대로 정확한 좌표를 클릭하고, 정해진 문장을 타이핑하며, 화면 속 특정 이미지를 찾아내기까지 하는데, 사람과 다른 점은 지치지 않고 똑같은 작업을 몇 번이고 정확하게 반복한다는 것입니다. pyautogui가 유용한 대표적인 상황 반복적인 클릭 작업이 많은 사내 시스템 업무 자동화 특정 시간마다 실행해야 하는 프로그램 작업 자동화 게임이나 소프트웨어 테스트 시 반복 입력 시뮬레이션 화면 캡처와 이미지 인식을 결합한 자동 작업 흐름 구성 매크로 프로그램을 대...
자세한 내용 보기

29.Python subprocess로 외부 명령어 실행하기: VSCode 실전 활용법

이미지
저도 처음에는 회사에서 매일 반복하던 번거로운 서버 배포 작업을 자동화해 보려고, 파이썬 스크립트 안에 깃( git ) 명령어를 넣어 실행하는 코드를 짰던 것이 시작이었습니다. 분명 내 터미널에 직접 입력할 때는 잘만 되던 명령어가, 파이썬 코드로 실행하니 자꾸 FileNotFoundError 만 뱉어내서 도대체 뭐가 문제인지 몇 시간이나 소스 코드 이 줄 저 줄을 뜯어고치며 밤새 삽질을 했습니다. 알고 보니 코드가 아니라 VS Code가 명령 프로그램의 위치를 찾지 못하는 'PATH 환경변수' 문제였죠. 실행 경로를 명시해 주자마자 스크립트가 배포 작업을 알아서 척척 단 5초 만에 끝내는 걸 보고 , 저는 이 파이썬 자동화의 강력함에 완전히 매료되었습니다. 이번 글에서는 그때의 시행착오를 바탕으로 subprocess 를 활용해 외부 명령어를 안전하게 제어하는 방법을 정리해 보겠습니다. Python 코드 안에서 터미널 명령어를 직접 실행하고 싶었던 적이 있으신가요? 예를 들어 git , ffmpeg , curl 같은 외부 프로그램을 Python 스크립트 안에서 자동으로 호출하고 그 결과를 받아와야 하는 경우가 생각보다 자주 발생합니다. 이럴 때 필요한 것이 바로 subprocess 모듈이며, 이를 활용하면 Python이 마치 터미널을 대신 조작하는 것처럼 외부 프로그램을 자유자재로 실행할 수 있습니다. 이번 글에서는 VSCode 환경에서 Python subprocess를 활용해 외부 명령어를 실행하고 결과를 처리하는 방법을 실전 예제와 함께 정리해보겠습니다. subprocess란 무엇인가 Python에서 외부 프로세스를 실행하는 표준 모듈 subprocess 는 Python 표준 라이브러리에 내장된 모듈로, Python 코드 안에서 운영체제의 명령어나 다른 프로그램을 새로운 프로세스로 실행할 수 있게 해줍니다. 쉽게 말해 여러분이 평소 터미널에 직접 타이핑하던 명령어를, Python 코드가 대신 입력해주고 그 결과까지 받아와주는 것이...
자세한 내용 보기