북마크

인증된 사용자의 북마크한 포스트를 저장하고 관리합니다

Bookmarks 엔드포인트를 사용하면 인증된 사용자의 북마크된 게시물을 조회, 추가 및 제거할 수 있습니다. 북마크는 비공개이며, 생성한 사용자만 볼 수 있습니다.

​

개요

북마크 보기

북마크한 모든 포스트 가져오기

북마크 추가

게시물을 북마크에 추가하기

북마크 제거

게시물 북마크 해제하기

북마크 폴더

북마크를 폴더로 정리하기

---

​

엔드포인트

Method	Endpoint	Description
GET	/2/users/:id/bookmarks	사용자의 북마크 가져오기
POST	/2/users/:id/bookmarks	게시물을 북마크로 추가
DELETE	/2/users/:id/bookmarks/:tweet_id	북마크에서 제거
GET	/2/users/:id/bookmarks/folders	북마크 폴더 가져오기
GET	/2/users/:id/bookmarks/folders/:folder_id	폴더에 포함된 포스트 가져오기

---

​

예제: 북마크 가져오기

curl "https://api.x.com/2/users/123456789/bookmarks?\
tweet.fields=created_at,author_id,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

예제: 북마크 추가

curl -X POST "https://api.x.com/2/users/123456789/bookmarks" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 Project 및 App
• OAuth 2.0 PKCE 또는 3-legged OAuth를 통한 사용자 액세스 토큰

조회 빠른 시작

사용자의 북마크 조회

관리 빠른 시작

북마크 추가 및 삭제

통합 가이드

핵심 개념 및 모범 사례

API 참조 문서

전체 엔드포인트 문서