`Client`

class tweepy.Client(bearer_token=None, consumer_key=None, consumer_secret=None, access_token=None, access_token_secret=None, *, return_type=Response, wait_on_rate_limit=False)

트위터 API v2 클라이언트(Client)

버전 4.0에 추가.

버전 4.15에서 변경: Removed block and unblock methods, as the endpoints they use have been removed

매개변수

bearer_token (str | None) – Twitter API OAuth 2.0 Bearer Token / Access Token
consumer_key (str | None) – Twitter API OAuth 1.0a Consumer Key
consumer_secret (str | None) – Twitter API OAuth 1.0a Consumer Secret
access_token (str | None) – Twitter API OAuth 1.0a Access Token
access_token_secret (str | None) – Twitter API OAuth 1.0a Access Token Secret
return_type (type[dict | requests.Response | Response]) – API 요청으로 반환받을 값의 형태
wait_on_rate_limit (bool) – API 호출 제한에 도달했을때 기다릴지의 여부

session

API 요청에 사용되는 요청 세션(Requests Session)

유형: requests.Session

user_agent

API 요청에 사용되는 사용자 에이전트(User agent)

유형: str

트위터 API v2 엔드포인트	`Client` 메서드
트윗
*Bookmarks*
DELETE /2/users/:id/bookmarks/:tweet_id	`Client.remove_bookmark()`
GET /2/users/:id/bookmarks	`Client.get_bookmarks()`
POST /2/users/:id/bookmarks	`Client.bookmark()`
*Hide replies*
부여: /2/tweets/:id/hidden	`Client.hide_reply()`
부여: /2/tweets/:id/hidden	`Client.unhide_reply()`
*Likes*
삭제: /2/users/:id/likes/:tweet_id	`Client.unlike()`
가져오기: /2/tweets/:id/liking_users	`Client.get_liking_users()`
가져오기: /2/users/:id/liked_tweets	`Client.get_liked_tweets()`
게시: /2/users/:id/likes	`Client.like()`
*Manage Tweets*
삭제: /2/tweets/:id	`Client.delete_tweet()`
게시: /2/tweets	`Client.create_tweet()`
*Quote Tweets*
GET /2/tweets/:id/quote_tweets	`Client.get_quote_tweets()`
*Retweets*
삭제: /2/users/:id/retweets/:source_tweet_id	`Client.unretweet()`
가져오기: /2/tweets/:id/retweeted_by	`Client.get_retweeters()`
게시: /2/users/:id/retweets	`Client.retweet()`
*Search Tweets*
가져오기: /2/tweets/search/all	`Client.search_all_tweets()`
가져오기: /2/tweets/search/recent	`Client.search_recent_tweets()`
*Timelines*
가져오기: /2/users/:id/mentions	`Client.get_users_mentions()`
GET /2/users/:id/timelines/reverse_chronological	`Client.get_home_timeline()`
가져오기: /2/users/:id/tweets	`Client.get_users_tweets()`
*Tweet counts*
가져오기: /2/tweets/counts/all	`Client.get_all_tweets_count()`
가져오기: /2/tweets/counts/recent	`Client.get_recent_tweets_count()`
*Tweet lookup*
가져오기: /2/tweets/:id	`Client.get_tweet()`
가져오기: /2/tweets	`Client.get_tweets()`
사용자
*Blocks*
가져오기: /2/users/:id/blocking	`Client.get_blocked()`
*Follows*
삭제: /2/users/:source_user_id/following/:target_user_id	`Client.unfollow_user()`
가져오기: /2/users/:id/followers	`Client.get_users_followers()`
가져오기: /2/users/:id/following	`Client.get_users_following()`
게시: /2/users/:id/following	`Client.follow_user()`
*Mutes*
삭제: /2/users/:source_user_id/muting/:target_user_id	`Client.unmute()`
가져오기: /2/users/:id/muting	`Client.get_muted()`
게시: /2/users/:id/muting	`Client.mute()`
*User lookup*
가져오기: /2/users/:id	`Client.get_user()`
가져오기: /2/users/by/username/:username	`Client.get_user()`
가져오기: /2/users	`Client.get_users()`
가져오기: /2/users/by	`Client.get_users()`
GET /2/users/me	`Client.get_me()`
스페이스
*Search Spaces*
가져오기: /2/spaces/search	`Client.search_spaces()`
*Spaces lookup*
가져오기: /2/spaces	`Client.get_spaces()`
가져오기: /2/spaces/:id	`Client.get_space()`
가져오기: /2/spaces/:id/buyers	`Client.get_space_buyers()`
GET /2/spaces/:id/tweets	`Client.get_space_tweets()`
가져오기: /2/spaces/by/creator_ids	`Client.get_spaces()`
Direct Messages
*Direct Messages lookup*
GET /2/dm_conversations/:dm_conversation_id/dm_events	`Client.get_direct_message_events()`
GET /2/dm_conversations/with/:participant_id/dm_events	`Client.get_direct_message_events()`
GET /2/dm_events	`Client.get_direct_message_events()`
*Manage Direct Messages*
POST /2/dm_conversations	`Client.create_direct_message_conversation()`
POST /2/dm_conversations/:dm_conversation_id/messages	`Client.create_direct_message()`
POST /2/dm_conversations/with/:participant_id/messages	`Client.create_direct_message()`
리스트
*List Tweets lookup*
가져오기: /2/lists/:id/tweets	`Client.get_list_tweets()`
*List follows*
삭제: /2/users/:id/followed_lists/:list_id	`Client.unfollow_list()`
가져오기: /2/lists/:id/followers	`Client.get_list_followers()`
가져오기: /2/users/:id/followed_lists	`Client.get_followed_lists()`
게시: /2/users/:id/followed_lists	`Client.follow_list()`
*List lookup*
가져오기: /2/lists/:id	`Client.get_list()`
가져오기: /2/users/:id/owned_lists	`Client.get_owned_lists()`
*List members*
삭제: /2/lists/:id/members/:user_id	`Client.remove_list_member()`
가져오기: /2/lists/:id/members	`Client.get_list_members()`
가져오기: /2/users/:id/list_memberships	`Client.get_list_memberships()`
게시: /2/lists/:id/members	`Client.add_list_member()`
*Manage Lists*
삭제: /2/lists/:id	`Client.delete_list()`
게시: /2/lists/:id	`Client.update_list()`
게시: /2/lists	`Client.create_list()`
*Pinned Lists*
삭제: /2/users/:id/pinned_lists/:list_id	`Client.unpin_list()`
가져오기: /2/users/:id/pinned_lists	`Client.get_pinned_lists()`
게시: /2/users/:id/pinned_lists	`Client.pin_list()`
표준 작업(Compliance)
*Batch Compliance*
가져오기: /2/compliance/jobs	`Client.get_compliance_jobs()`
가져오기: /2/compliance/jobs/:id	`Client.get_compliance_job()`
게시: /2/compliance/jobs	`Client.create_compliance_job()`

트윗

Bookmarks

Client.remove_bookmark(tweet_id)

Allows a user or authenticated user ID to remove a Bookmark of a Tweet.

참고

A request is made beforehand to Twitter’s API to determine the authenticating user’s ID. This is cached and only done once per Client instance for each access token used.

버전 4.8에 추가.

매개변수: tweet_id (int | str) – The ID of the Tweet that you would like the id to remove a Bookmark of.
예외 발생: TypeError – If the access token isn’t set
반환값
반환 형식: dict | requests.Response | Response

참조

https://developer.twitter.com/en/docs/twitter-api/tweets/bookmarks/api-reference/delete-users-id-bookmarks-tweet_id

Client.get_bookmarks(*, expansions=None, max_results=None, media_fields=None, pagination_token=None, place_fields=None, poll_fields=None, tweet_fields=None, user_fields=None)

Allows you to get an authenticated user’s 800 most recent bookmarked Tweets.

참고

A request is made beforehand to Twitter’s API to determine the authenticating user’s ID. This is cached and only done once per Client instance for each access token used.

버전 4.8에 추가.

매개변수

expansions (list[str] | str | None) – expansions Parameter
max_results (int | None) – 페이지당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
media_fields (list[str] | str | None) – media_fields
pagination_token (str | None) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된 next_token 값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된 previous_token 값을 전달하면 됩니다.
place_fields (list[str] | str | None) – place_fields
poll_fields (list[str] | str | None) – poll_fields
tweet_fields (list[str] | str | None) – tweet_fields
user_fields (list[str] | str | None) – user_fields

예외 발생

TypeError – If the access token isn’t set

반환값

반환 형식

Client

트윗

Bookmarks

답글 숨기기

마음에 들어요

트윗 관리

Quote Tweets

리트윗

트윗 검색

타임라인

트윗 카운트

트윗 자세히보기

사용자

차단

팔로우

뮤트

사용자 자세히보기

스페이스

스페이스 검색

스페이스 자세히보기

Direct Messages

Direct Messages lookup

Manage Direct Messages

리스트

리스트 트윗 자세히보기

리스트 구독(Follow)

리스트 자세히보기

리스트 구성원

리스트 관리

리스트 고정

표준 작업(Compliance)

표준 준수 하 일괄 작업(Batch compliance)

`Client`