북마크 관리

X API를 사용하여 북마크를 추가하고 제거합니다

이 가이드는 X API를 사용하여 북마크를 추가하고 삭제하는 방법을 단계별로 안내합니다.

사전 준비 사항

시작하기 전에 다음이 필요합니다.

• 승인이 완료된 App이 있는 개발자 계정
• bookmark.write 권한 범위를 가진 사용자 액세스 토큰 (OAuth 2.0 PKCE)

---

​

북마크 추가하기

1. 사용자 ID 가져오기

   인증된 사용자의 ID가 필요합니다. /2/users/me 엔드포인트나 사용자 조회 엔드포인트를 사용해 확인할 수 있습니다.

2. 게시물 ID 가져오기

   게시물을 볼 때, 게시물 페이지의 URL에서 게시물 ID를 확인합니다:

   https://x.com/XDevelopers/status/1460323737035677698
                                   └── 이것이 게시물 ID입니다
   
3. 북마크 추가하기

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"tweet_id": "1460323737035677698"}'
   
4. 응답 확인하기

   {
     "data": {
       "bookmarked": true
     }
   }
   

---

​

북마크 삭제

북마크에서 게시물을 삭제하려면:

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

응답:

{
  "data": {
    "bookmarked": false
  }
}

---

​

필수 스코프

OAuth 2.0 PKCE를 사용할 때는 액세스 토큰에 다음 스코프가 포함되어야 합니다.

Scope	설명
bookmark.write	북마크 추가 및 제거
tweet.read	게시물 데이터 읽기
users.read	사용자 데이터 읽기

---

​

다음 단계

북마크 조회

북마크한 포스트 가져오기

API 참조 문서

엔드포인트 전체 문서