tweepy.Client
— 트위터 API v2 레퍼런스¶
- 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에 추가.
- 매개변수
bearer_token (Optional[str]) – 트위터 API 베어러(Bearer) 토큰
consumer_key (Optional[str]) – 트위터 API Consumer Key
consumer_secret (Optional[str]) – 트위터 API Consumer Secret
access_token (Optional[str]) – 트위터 API Access Token
access_token_secret (Optional[str]) – 트위터 API Access Token Secret
return_type (Type[Union[dict, requests.Response, Response]]) – API 요청으로 반환받을 값의 형태
wait_on_rate_limit (bool) – API 호출 제한에 도달했을때 기다릴지의 여부
- session¶
API 요청에 사용되는 요청 세션(Requests Session)
트위터 API v2 엔드포인트 |
|
---|---|
트윗¶
답글 숨기기¶
- Client.hide_reply(id, *, user_auth=True)¶
트윗의 답글을 숨깁니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.unhide_reply(id, *, user_auth=True)¶
트윗의 답글 숨김을 해제합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
마음에 들어요¶
- Client.unlike(tweet_id, *, user_auth=True)¶
〈마음에 들어요’를 취소합니다.
〈마음에 들어요’를 표시하지 않은 트윗이나, 이미 〈마음에 들어요’를 취소한 트윗에 이 요청을 보내면, 특별한 처리 없이도 요청이 성공합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_liking_users(id, *, expansions, media_fields, place_fields, poll_fields, tweet_fields, user_fields, user_auth=False)¶
트윗에 〈마음에 들어요’를 표시한 사용자에 대한 정보를 얻을 수 있습니다.
버전 4.6에서 변경: Added
max_results
andpagination_token
parameters- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 1000 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
media_fields (Union[List[str], str]) – media_fields
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_liked_tweets(id, *, expansions, max_results, media_fields, pagination_token, place_fields, poll_fields, tweet_fields, user_fields, user_auth=False)¶
사용자가 〈마음에 들어요’를 표시한 트윗에 대한 정보를 얻을 수 있습니다.
이 엔드포인트를 통해 반환된 트윗은, 프로젝트 수준(Project-level)의 트윗 한도 에 계산됩니다.
- 매개변수
id (Union[int, str]) – 〈마음에 들어요’를 표시한 트윗 목록을 가져올 대상 사용자의 ID.
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 5에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
media_fields (Union[List[str], str]) – media_fields
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.like(tweet_id, *, user_auth=True)¶
트윗에 〈마음에 들어요’를 표시합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/tweets/likes/api-reference/post-users-id-likes
트윗 관리¶
- Client.delete_tweet(id, *, user_auth=True)¶
현재 인증된 사용자의 트윗을 삭제합니다.
버전 4.3에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.create_tweet(*, direct_message_deep_link=None, for_super_followers_only=None, place_id=None, media_ids=None, media_tagged_user_ids=None, poll_duration_minutes=None, poll_options=None, quote_tweet_id=None, exclude_reply_user_ids=None, in_reply_to_tweet_id=None, reply_settings=None, text=None, user_auth=True)¶
현재 인증된 사용자로서 트윗을 작성합니다.
버전 4.3에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
direct_message_deep_link (Optional[str]) – 계정과의 1:1 쪽지 링크를 트윗함.
for_super_followers_only (Optional[bool]) – 슈퍼 팔로워 전용 트윗을 작성할지의 여부.
place_id (Optional[str]) – 트윗에 포함될 위치의 ID값.
media_ids (Optional[List[int, str]]) – 트윗에 포함할 미디어의 ID. 요청이
tagged_user_ids
값을 포함하고 있는 경우에만 필수가 됩니다.media_tagged_user_ids (Optional[List[Union[int, str]]]) – 트윗 미디어에 태그할 사용자들의 ID 목록. 태그하려는 사용자가 사진 태그를 허용하지 않은 경우, 트윗이 성공적으로 작성되더라도 태그된 사용자 목록에 이름이 표시되지 않습니다.
poll_duration_minutes (Optional[int]) – 투표가 포함된 트윗의 투표 기간. 요청이
poll.options
값을 포함하고 있는 경우에만 필수가 됩니다.quote_tweet_id (Optional[Union[int, str]]) – 인용 리트윗하려는 트윗의 링크.
exclude_reply_user_ids (Optional[List[Union[int, str]]]) – 답글에서 제외할 사용자의 ID 목록.
in_reply_to_tweet_id (Optional[Union[int, str]]) – 답글을 작성할 대상 트윗의 ID. 요청에
exclude_reply_user_ids
값이 포함되어 있는 경우, 이in_reply_to_tweet_id
가 반드시 포함되어야 함에 유의하시기 바랍니다.reply_settings (Optional[str]) – 답글을 작성할 수 있는 사용자를 설정 합니다. 《mentionedUsers》(내가 멘션하는 사람들만), 《following》(내가 팔로우하는 사람들) 만 입력할 수 있으며, 따로 지정하지 않으면 《모든 사람 답글 작성 가능》으로 설정됩니다.
text (Optional[str]) – 트윗의 본문 텍스트. 트윗에
media.media_ids
가 포함되어 있지 않은 경우, 이 값은 필수가 됩니다.user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/tweets/manage-tweets/api-reference/post-tweets
리트윗¶
- Client.unretweet(source_tweet_id, *, user_auth=True)¶
현재 인증된 사용자로서 리트윗을 취소합니다.
리트윗하지 않은 트윗이나, 이미 리트윗을 취소한 트윗에 이 요청을 보내면, 특별한 처리 없이도 요청이 성공합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_retweeters(id, *, expansions, media_fields, place_fields, poll_fields, tweet_fields, user_fields, user_auth=False)¶
트윗을 리트윗한 사용자들에 대한 정보를 얻을 수 있습니다.
버전 4.6에서 변경: Added
max_results
andpagination_token
parameters- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 1000 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
media_fields (Union[List[str], str]) – media_fields
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.retweet(tweet_id, *, user_auth=True)¶
지정한 트윗을 현재 인증된 사용자로서 리트윗합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
트윗 검색¶
- Client.search_all_tweets(query, *, end_time, expansions, max_results, media_fields, next_token, place_fields, poll_fields, since_id, start_time, tweet_fields, until_id, user_fields)¶
이 엔드포인트는 학술 연구 제품 트랙 사용이 승인된 사용자만 사용할 수 있습니다.
이 전체 아카이브 검색 엔드포인트는 모든 공개 트윗의 전체 기록 중 검색 쿼리와 맞는 전체 트윗을 반환합니다. 범위는 트위터의 첫 번째 트윗부터이며, 이는 2006년 3월 26일에 작성되었습니다.
이 엔드포인트를 통해 반환된 트윗은, 프로젝트 수준(Project-level)의 트윗 한도 에 계산됩니다.
버전 4.6에서 변경: Added
sort_order
parameter- 매개변수
query (str) – 트윗 검색에 사용할 쿼리. 최대 1024자.
end_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴로 입력하는 매개변수.
start_time
매개변수와 같이 사용하는 것이 권장됩니다.트윗 검색 기간의 끝을 의미하며, 두 개로 세분화되었고 계산에 기준값을 포함하지 않습니다. (예: 12:00:01로 설정하면 검색 기간에 12:00:00까지만 고려되고 그 다음 초는 고려되지 않음)start_time
매개변수가 주어지지 않은 경우,end_time
으로부터 30일 전까지가 검색 기간이 됩니다. 이 매개변수가 지정되지 않은 경우의 기본값은 〈현재 시점으로부터 30초 전’입니다.expansions (Union[List[str], str]) – Expansions
max_results (int) – 요청당 반환받을 결과의 수. 10부터 트위터 시스템 제한 수치 (현재 500) 사이의 값이며, 기본값은 10입니다. (요청 당 10개의 결과 반환)
media_fields (Union[List[str], str]) – media_fields
next_token (str) – 이 매개변수는 결과의 다음 〈page〉 (페이지) 를 가져오는 데 사용됩니다. 이 매개변수의 값은 API에서 제공된 값으로만 사용 가능하며, 이는 수정할 수 없습니다. 자세한 사항은 Pagination 페이지를 참고하시기 바랍니다.
place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
since_id (Union[int, str]) – 지정한 ID값보다 더 큰 ID값을 가지는 (즉, 더 최근의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈초과’를 의미, 즉 기준값을 포함하지 않음). 같은 요청에
start_time
값을 같이 전달할 경우,since_id
값만 사용됩니다.sort_order (str) – This parameter is used to specify the order in which you want the Tweets returned. By default, a request will return the most recent Tweets first (sorted by recency).
start_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 시작점을 지정하는 UTC 타임스탬프값입니다. 포함적으로 계산되며(〈이상’을 의미, 즉 기준값을 포함 - 예: 12:00:01로 지정하면 01초도 검색 범위에 포함됨), 이 매개변수에 값을 지정하지 않으면 기본적으로 30일 이전까지의 결과를 반환합니다.
tweet_fields (Union[List[str], str]) – tweet_fields
until_id (Union[int, str]) – 지정한 ID값보다 더 작은 ID값을 가지는 (즉, 더 이전의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈미만’을 의미, 즉 기준값을 포함하지 않음). 같은 요청에
since_id
값을 같이 전달할 경우,since_id
값만 사용됩니다.user_fields (Union[List[str], str]) – user_fields
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/tweets/search/api-reference/get-tweets-search-all
- Client.search_recent_tweets(query, *, end_time, expansions, max_results, media_fields, next_token, place_fields, poll_fields, since_id, start_time, tweet_fields, until_id, user_fields, user_auth=False)¶
이 〈최근 검색〉 엔드포인트는 검색 조건과 일치하는, 최근 7일간의 트윗을 반환합니다.
이 엔드포인트를 통해 반환된 트윗은, 프로젝트 수준(Project-level)의 트윗 한도 에 계산됩니다.
버전 4.6에서 변경: Added
sort_order
parameter- 매개변수
query (str) – 트윗 검색에 사용할 쿼리(조건). 일반(Standard) 프로젝트 를 기본(Basic) 권한(Access level) 에서 사용 중인 경우, 기본적인 연산자 를 포함해 최대 512자까지의 쿼리를 사용할 수 있습니다. 학술 연구용 프로젝트 를 기본 권한(Basic access level) 에서 사용 중인 경우, 기본적인 연산자를 포함해 최대 1,024자까지의 쿼리를 사용할 수 있습니다.
end_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 끝점을 지정하는 UTC 타임스탬프값입니다. 이분법적·비포함적으로 계산되며(〈미만’을 의미, 즉 기준값을 포함하지 않음 - 예: 12:00:01로 지정하면 01초는 검색 범위에서 제외됨), 이 매개변수에 값을 지정하지 않으면 기본적으로 30초 이전까지의 결과를 반환합니다.
expansions (Union[List[str], str]) – Expansions
max_results (int) – 요청 당 반환받을 결과의 수. 10 이상 100 이하의 자연수로 입력해야 하며, 값을 따로 지정하지 않으면 기본적으로 요청 당 10개의 결과를 반환합니다.
media_fields (Union[List[str], str]) – media_fields
next_token (str) – 반환받은 결과의 다음 〈페이지’를 가져올때 사용되는 매개변수. 이 매개변수의 값은 API에서 제공된 값으로만 사용 가능하며, 이는 수정할 수 없습니다.
place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
since_id (Union[int, str]) – 지정한 ID값보다 더 큰 ID값을 가지는 (즉, 더 최근의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈초과’를 의미, 즉 기준값을 포함하지 않음). 같은 요청에
start_time
값을 같이 전달할 경우,since_id
값만 사용됩니다.sort_order (str) – This parameter is used to specify the order in which you want the Tweets returned. By default, a request will return the most recent Tweets first (sorted by recency).
start_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 시작점(단, 최근 7일 이내)을 지정하는 UTC 타임스탬프값입니다. 이분법적·포함적으로 계산되며(〈이상’을 의미, 즉 기준값을 포함함 - 예: 12:00:01로 지정하면 01초가 검색 범위에 포함됨), 이 매개변수에 값을 지정하지 않으면 기본적으로 현재로부터 7일 이전까지의 결과를 반환합니다. 같은 요청에
since_id
값을 같이 전달할 경우,since_id
값만 사용됩니다.tweet_fields (Union[List[str], str]) – tweet_fields
until_id (Union[int, str]) – 지정한 ID값보다 더 작은 ID값을 가지는 (즉, 더 이전의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈미만’을 의미, 즉 기준값을 포함하지 않음).
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
타임라인¶
- Client.get_users_mentions(id, *, end_time, expansions, max_results, media_fields, pagination_token, place_fields, poll_fields, since_id, start_time, tweet_fields, until_id, user_fields, user_auth=False)¶
지정한 사용자에게 멘션하고 있는 트윗을 반환합니다. 따로 값을 지정하지 않으면, 요청당 최근 10개의 트윗을 반환합니다. 페이지화(Pagination)를 이용하면, 최대 최근 800개의 결과를 가져올 수 있습니다.
이 엔드포인트를 통해 반환된 트윗은, 프로젝트 수준(Project-level)의 트윗 한도 에 계산됩니다.
- 매개변수
id (Union[int, str]) – 지정할 사용자의 고유 ID값. 사용자의 ID값은 user/lookup 엔드포인트를 이용해 참조해올 수 있습니다. 트위터 ID값에 대한 자세한 설명은 여기 를 참고하세요.
end_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 시작점을 지정하는 UTC 타임스탬프값입니다. 이분법적·포함적으로 계산됩니다(〈이상’을 의미, 즉 기준값을 포함함 - 예: 12:00:01로 지정하면 01초는 검색 범위에 포함됨). 밀리세컨드값을 지원하지 않습니다.
expansions (Union[List[str], str]) – Expansions
max_results (int) – 요청 당 가져올 트윗의 개수(최대 100개)를 지정할 수 있는 매개변수. 따로 설정하지 않으면 기본적으로 요청 당 최대 10개의 결과만 반환하며, 최솟값은 5입니다. 페이지화(Pagination)를 이용해 요청당
max_results
보다 적은 결과값을 받아오는 것이 가능합니다.media_fields (Union[List[str], str]) – media_fields
pagination_token (str) – 이 매개변수는
next_token
이나previous_token
값을 이용해, 결과값의 이전 혹은 다음 페이지를 조회하는 데 사용되는 매개변수입니다. 이 매개변수의 값은 API에서 제공된 값으로만 사용 가능하며, 이는 수정할 수 없습니다.place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
since_id (Union[int, str]) – 지정한 ID값보다 더 큰 ID값을 가지는 (즉, 더 최근의) 트윗들만 검색 결과에 포함합니다. 단, 트위터 API를 통해 가져올 수 있는 트윗 수에 한계가 있다는 것을 유의해야 합니다. 만약 이 값 때문에 API 호출 제한에 도달할 경우, 이 값인
since_id
가 가능한 선에서 최대한 작은(즉, 최대한 예전의) ID값으로 강제 변경됩니다. 트위터 ID값에 대한 자세한 설명은 여기 를 참고하세요.start_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 시작점을 지정하는 UTC 타임스탬프값입니다. 이분법적·포함적으로 계산됩니다(〈이상’을 의미, 즉 기준값을 포함함 - 예: 12:00:01로 지정하면 01초는 검색 범위에 포함됨). 밀리세컨드값을 지원하지 않습니다.
tweet_fields (Union[List[str], str]) – tweet_fields
until_id (Union[int, str]) – 지정한 ID값보다 더 작은 ID값을 가지는 (즉, 더 오래된) 트윗들만 검색 결과에 포함합니다. 단, 트위터 API를 통해 가져올 수 있는 트윗 수에 한계가 있다는 것을 유의해야 합니다. 만약 이 값 때문에 API 호출 제한에 도달할 경우, 이 값인
until_id
가 가능한 선에서 약간 더 큰(즉, 최대한 오래된) ID값으로 강제 변경됩니다. 트위터 ID값에 대한 자세한 설명은 여기 를 참고하세요.user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_users_tweets(id, *, end_time, exclude, expansions, max_results, media_fields, pagination_token, place_fields, poll_fields, since_id, start_time, tweet_fields, until_id, user_fields, user_auth=False)¶
ID로 지정한 사용자가 작성 또는 리트윗한 트윗들을 반환합니다. 기본적으로, 요청 당 10개의 결과를 반환합니다. 페이지화(Pagination)를 이용하면, 최대 최근 3,200개의 결과를 가져올 수 있습니다.
이 엔드포인트를 통해 반환된 트윗은, 프로젝트 수준(Project-level)의 트윗 한도 에 계산됩니다.
- 매개변수
id (Union[int, str]) – 지정할 사용자의 고유 ID값. 사용자의 ID값은 user/lookup 엔드포인트를 이용해 참조해올 수 있습니다. 트위터 ID값에 대한 자세한 설명은 여기 를 참고하세요.
end_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 끝점을 지정하는 UTC 타임스탬프값입니다. 최대 최근 3200개의 결과를 받아올 수 있습니다. 이분법적·포함적으로 계산되며(〈이하’를 의미, 즉 기준값을 포함함 - 예: 12:00:01로 지정하면 01초는 검색 범위에 포함됨), 최솟값은 2010-11-06T00:00:01Z 입니다. 밀리세컨드값을 지원하지 않습니다.
exclude (Union[List[str], str]) – 결과값에서 제외할 트윗 종류를 구분하는, 쉼표(,)로 구분된 리스트입니다.
exclude=retweets
를 사용해도, 최대 3200개까지의 결과를 반환받을 수 있습니다. 단,exclude=replies
를 같이 사용하면, 최대 800개까지의 결과만을 반환받을 수 있습니다.expansions (Union[List[str], str]) – Expansions
max_results (int) – 요청 당 가져올 트윗의 개수(최대 100개)를 지정할 수 있는 매개변수. 따로 설정하지 않으면 기본적으로 요청 당 최대 10개의 결과만 반환하며, 최솟값은 5입니다. 페이지화(Pagination)를 이용해 요청당
max_results
보다 적은 결과값을 받아오는 것이 가능합니다.media_fields (Union[List[str], str]) – media_fields
pagination_token (str) – 이 매개변수는
next_token
이나previous_token
값을 이용해, 결과값의 이전 혹은 다음 페이지를 조회하는 데 사용되는 매개변수입니다. 이 매개변수의 값은 API에서 제공된 값으로만 사용 가능하며, 이는 수정할 수 없습니다.place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
since_id (Union[int, str]) – 지정한 ID값보다 더 큰 ID값을 가지는 (즉, 더 최근의) 트윗들만 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈초과’를 의미, 즉 기준값을 포함하지 않음). 같은 요청에
start_time
값을 같이 전달할 경우,since_id
값만 사용됩니다.start_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗을 가져올 범위의 시작점을 지정하는 UTC 타임스탬프값입니다. 최대 최근 3200개의 트윗만을 가져올 수 있습니다. 이분법적·포함적으로 계산되며(〈이상’을 의미, 즉 기준값을 포함 - 예: 12:00:01로 지정하면 01초도 검색 범위에 포함됨), 최솟값은 2010-11-06T00:00:00Z 입니다. 밀리세컨드값을 지원하지 않습니다.
tweet_fields (Union[List[str], str]) – tweet_fields
until_id (Union[int, str]) – 지정한 ID값보다 더 작은 ID값을 가지는 (즉, 더 오래된) 트윗들만 결과에 포함합니다. 최대 최근 3200개의 트윗만을 가져올 수 있습니다. 비포함적으로 계산됩니다. (〈미만’을 의미) 만약 이 값 때문에 API 호출 제한에 도달할 경우, 이 값인
until_id
가 가능한 선에서 약간 더 큰(즉, 최대한 오래된) ID값으로 강제 변경됩니다.user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/tweets/timelines/api-reference/get-users-id-tweets
트윗 카운트¶
- Client.get_all_tweets_count(query, *, end_time, granularity, next_token, since_id, start_time, until_id)¶
이 엔드포인트는 학술 연구 제품 트랙 사용이 승인된 사용자만 사용할 수 있습니다.
이 전체 아카이브 검색 엔드포인트는 모든 공개 트윗의 전체 기록 중 검색 쿼리와 맞는 전체 트윗을 반환합니다. 범위는 트위터의 첫 번째 트윗부터이며, 이는 2006년 3월 26일에 작성되었습니다.
- 매개변수
query (str) – 트윗 검색에 사용할 쿼리. 최대 1024자.
end_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴로 입력하는 매개변수.
start_time
매개변수와 같이 사용하는 것이 권장됩니다.트윗 검색 기간의 끝을 의미하며, 두 개로 세분화되었고 계산에 기준값을 포함하지 않습니다. (예: 12:00:01로 설정하면 검색 기간에 12:00:00까지만 고려되고 그 다음 초는 고려되지 않음)start_time
매개변수가 주어지지 않은 경우,end_time
으로부터 30일 전까지가 검색 기간이 됩니다. 이 매개변수가 지정되지 않은 경우의 기본값은 〈현재 시점으로부터 30초 전’입니다.granularity (str) – This is the granularity that you want the timeseries count data to be grouped by. You can request
minute
,hour
, orday
granularity. The default granularity, if not specified ishour
.next_token (str) – 이 매개변수는 결과의 다음 〈page〉 (페이지) 를 가져오는 데 사용됩니다. 이 매개변수의 값은 API에서 제공된 값으로만 사용 가능하며, 이는 수정할 수 없습니다. 자세한 사항은 Pagination 페이지를 참고하시기 바랍니다.
since_id (Union[int, str]) – 지정한 ID값보다 더 큰 ID값을 가지는 (즉, 더 최근의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈초과’를 의미, 즉 기준값을 포함하지 않음). 같은 요청에
start_time
값을 같이 전달할 경우,since_id
값만 사용됩니다.start_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 시작점을 지정하는 UTC 타임스탬프값입니다. 포함적으로 계산되며(〈이상’을 의미, 즉 기준값을 포함 - 예: 12:00:01로 지정하면 01초도 검색 범위에 포함됨), 이 매개변수에 값을 지정하지 않으면 기본적으로 30일 이전까지의 결과를 반환합니다.
until_id (Union[int, str]) – 지정한 ID값보다 더 작은 ID값을 가지는 (즉, 더 이전의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈미만’을 의미, 즉 기준값을 포함하지 않음). 같은 요청에
since_id
값을 같이 전달할 경우,since_id
값만 사용됩니다.
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/tweets/counts/api-reference/get-tweets-counts-all
- Client.get_recent_tweets_count(query, *, end_time, granularity, since_id, start_time, until_id)¶
이 엔드포인트는 지정한 조건에 맞는 최근 7일간의 트윗 관련 데이터를 반환합니다.
- 매개변수
query (str) – 트윗 검색에 사용할 쿼리(조건). 일반(Standard) 프로젝트 를 기본(Basic) 권한(Access level) 에서 사용 중인 경우, 기본적인 연산자 를 포함해 최대 512자까지의 쿼리를 사용할 수 있습니다. 학술 연구용 프로젝트 를 기본 권한(Basic access level) 에서 사용 중인 경우, 기본적인 연산자를 포함해 최대 1,024자까지의 쿼리를 사용할 수 있습니다.
end_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 끝점을 지정하는 UTC 타임스탬프값입니다. 이분법적·비포함적으로 계산되며(〈미만’을 의미, 즉 기준값을 포함하지 않음 - 예: 12:00:01로 지정하면 01초는 검색 범위에서 제외됨), 이 매개변수에 값을 지정하지 않으면 기본적으로 30초 이전까지의 결과를 반환합니다.
granularity (str) – This is the granularity that you want the timeseries count data to be grouped by. You can request
minute
,hour
, orday
granularity. The default granularity, if not specified ishour
.since_id (Union[int, str]) – 지정한 ID값보다 더 큰 ID값을 가지는 (즉, 더 최근의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈초과’를 의미, 즉 기준값을 포함하지 않음). 같은 요청에
start_time
값을 같이 전달할 경우,since_id
값만 사용됩니다.start_time (Union[datetime.datetime, str]) – YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339) 꼴의 값. 트윗 검색 범위의 시작점(단, 최근 7일 이내)을 지정하는 UTC 타임스탬프값입니다. 이분법적·포함적으로 계산되며(〈이상’을 의미, 즉 기준값을 포함함 - 예: 12:00:01로 지정하면 01초가 검색 범위에 포함됨), 이 매개변수에 값을 지정하지 않으면 기본적으로 현재로부터 7일 이전까지의 결과를 반환합니다. 같은 요청에
since_id
값을 같이 전달할 경우,since_id
값만 사용됩니다.until_id (Union[int, str]) – 지정한 ID값보다 더 작은 ID값을 가지는 (즉, 더 이전의) 트윗들만 검색 결과에 포함합니다. ID값은 비포함적으로 계산됩니다(〈미만’을 의미, 즉 기준값을 포함하지 않음).
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
트윗 자세히보기¶
- Client.get_tweet(id, *, expansions, media_fields, place_fields, poll_fields, twitter_fields, user_fields, user_auth=False)¶
ID로 지정한 하나의 트윗에 대한 다양한 정보를 반환합니다.
- 매개변수
expansions (Union[List[str], str]) – Expansions
media_fields (Union[List[str], str]) – media_fields
place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/tweets/lookup/api-reference/get-tweets-id
- Client.get_tweets(ids, *, expansions, media_fields, place_fields, poll_fields, twitter_fields, user_fields, user_auth=False)¶
ID값으로 지정한 하나의 트윗 또는 ID값의 목록으로 지정한 트윗들에 대한 다양한 정보를 반환합니다.
- 매개변수
ids (Union[List[int, str], str]) – 쉼표(,)로 구분된 트윗 ID값의 리스트. 요청 당 최대 100개까지만 전달할 수 있습니다. 값과 쉼표(,) 사이에 공백 문자를 넣지 않도록 유의하시기 바랍니다.
expansions (Union[List[str], str]) – Expansions
media_fields (Union[List[str], str]) – media_fields
place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/tweets/lookup/api-reference/get-tweets
사용자¶
차단¶
- Client.unblock(target_user_id, *, user_auth=True)¶
지정한 사용자를 차단 해제합니다.
차단 해제하려는 사용자가 이미 차단 해제되어 있거나, 차단하고 있지 않던 경우 특별한 처리 없이도 요청이 성공합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_blocked(*, expansions, max_results, pagination_token, tweet_fields, user_fields, user_auth=True)¶
현재 인증된 사용자가 차단한 사용자의 리스트를 반환합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 1000 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다.
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/users/blocks/api-reference/get-users-blocking
- Client.block(target_user_id, *, user_auth=True)¶
지정한 사용자를 차단합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
팔로우¶
- Client.unfollow_user(target_user_id, *, user_auth=True)¶
지정한 사용자를 팔로우 해제합니다.
팔로우 해제하려는 사용자가 이미 팔로우 해제되어 있거나, 팔로우하고 있지 않던 경우 특별한 처리 없이도 요청이 성공합니다.
버전 4.2에서 변경:
Client.unfollow()
로부터 이름 변경됨버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.unfollow(target_user_id, *, user_auth=True)¶
다음 함수와 동일함(Alias):
Client.unfollow_user()
버전 4.2부터 폐지됨:
Client.unfollow_user()
를 대신 사용해야 함
- Client.get_users_followers(id, *, expansions, max_results, pagination_token, tweet_fields, user_fields, user_auth=False)¶
ID로 지정한 사용자의 팔로워 리스트를 반환합니다.
- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 1000 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-followers
- Client.get_users_following(id, *, expansions, max_results, pagination_token, tweet_fields, user_fields, user_auth=False)¶
ID로 지정한 사용자가 팔로우중인 사용자들의 리스트를 반환합니다.
- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 1000 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-following
- Client.follow_user(target_user_id, *, user_auth=True)¶
지정한 사용자를 팔로우합니다.
대상 사용자가 비공개 계정인 경우, 이 엔드포인트는 팔로우 요청을 대신 보냅니다.
팔로우하려는 사용자가 이미 팔로우 되어 있거나, 대상 사용자가 비공개 계정이어서 팔로우 요청을 대신 보내는 경우 특별한 처리 없이도 요청이 성공합니다.
버전 4.2에서 변경:
Client.follow()
로부터 이름 변경됨버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.follow(target_user_id, *, user_auth=True)¶
다음 함수와 동일함(Alias):
Client.follow_user()
버전 4.2부터 폐지됨:
Client.follow_user()
를 대신 사용해야 함
뮤트¶
- Client.unmute(target_user_id, *, user_auth=True)¶
지정한 사용자를 뮤트 해제합니다.
뮤트 해제하려는 사용자가 이미 뮤트 해제되어 있거나, 뮤트하고 있지 않던 경우 특별한 처리 없이도 요청이 성공합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_muted(*, expansions, max_results, pagination_token, tweet_fields, user_fields, user_auth=True)¶
현재 인증된 사용자가 뮤트한 사용자의 리스트를 반환합니다.
버전 4.1에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 1000 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다.
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/users/mutes/api-reference/get-users-muting
- Client.mute(target_user_id, *, user_auth=True)¶
지정한 사용자를 뮤트합니다.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
사용자 자세히보기¶
- Client.get_user(*, id, username, expansions, tweet_fields, user_fields, user_auth=False)¶
ID 또는 사용자명(username)로 지정한 하나의 사용자에 대한 다양한 정보를 반환합니다.
- 매개변수
username (str) – 대상 사용자의 사용자명(username)
expansions (Union[List[str], str]) – Expansions
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 예외 발생
TypeError – ID값과 사용자명(username)이 둘 다 전달되지 않았거나, 둘 다 전달된 경우
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-id https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-by-username-username
- Client.get_users(*, ids, usernames, expansions, tweet_fields, user_fields, user_auth=False)¶
ID값 및 사용자명(username)으로 지정한 하나의 사용자 또는 ID값 및 사용자명(username)의 목록으로 지정한 사용자들에 대한 다양한 정보를 반환합니다.
- 매개변수
ids (Union[List[int, str], str]) – 쉼표(,)로 구분된 사용자 ID값의 리스트. 요청 당 최대 100개까지만 전달할 수 있습니다. 값과 쉼표(,) 사이에 공백 문자를 넣지 않도록 유의하시기 바랍니다.
usernames (Union[List[str], str]) – 쉼표(,)로 구분된 사용자명(username)의 리스트. 요청 당 최대 100개까지만 전달할 수 있습니다. 값과 쉼표(,) 사이에 공백 문자를 넣지 않도록 유의하시기 바랍니다.
expansions (Union[List[str], str]) – Expansions
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 예외 발생
TypeError – ID값과 사용자명(username)이 둘 다 전달되지 않았거나, 둘 다 전달된 경우
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-by
- Client.get_me(*, expansions, tweet_fields, user_fields, user_auth=True)¶
Returns information about an authorized user.
버전 4.5에 추가.
- 매개변수
expansions (Union[List[str], str]) – Expansions
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-me
스페이스¶
스페이스 검색¶
- Client.search_spaces(query, *, expansions, max_results, space_fields, state, user_fields)¶
지정한 조건에 맞는, 진행 중이거나 진행 예정인 스페이스들을 반환합니다.
버전 4.1에 추가.
버전 4.2에서 변경: 이제
state
가 필수 매개변수가 아님 (Optional)- 매개변수
query (str) – 스페이스 검색 조건. 스페이스의 제목에서 찾을 문자열을 입력하면 되고, 멘션이나 해시태그도 문자열 형태로 전달할 수 있습니다.
expansions (Union[List[str], str]) – Expansions
max_results (int) – 요청당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 합니다.
space_fields (Union[List[str], str]) – space_fields
state (str) – 어떤 상태의 스페이스를 반환받을지를 정하는 매개변수. 이 엔드포인트는 기본적으로 모든 스페이스를 반환합니다.
live
로 지정하면 현재 진행 중인 스페이스만 반환받을 수 있고,scheduled
로 지정하면 진행 예정인 스페이스만 반환받을 수 있습니다.user_fields (Union[List[str], str]) – user_fields
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/spaces/search/api-reference/get-spaces-search
스페이스 자세히보기¶
- Client.get_spaces(*, ids, user_ids, expansions, space_fields, user_fields)¶
여러 개의 진행 중이거나 진행 예정인 스페이스(특정 사용자 ID를 지정하면, 해당 사용자가 개설한 스페이스) 에 대한 다양한 정보를 반환합니다. 이 엔드포인트는 최대 100개의 쉼표(,)로 구분된 사용자 ID나 스페이스를 처리할 수 있습니다.
버전 4.1에 추가.
- 매개변수
- 예외 발생
TypeError – ID값과 사용자명(username)이 둘 다 전달되지 않았거나, 둘 다 전달된 경우
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/spaces/lookup/api-reference/get-spaces https://developer.twitter.com/en/docs/twitter-api/spaces/lookup/api-reference/get-spaces-by-creator-ids
- Client.get_space(id, *, expansions, space_fields, user_fields)¶
ID로 지정한 하나의 스페이스에 대한 다양한 정보를 반환합니다.
버전 4.1에 추가.
- 매개변수
expansions (Union[List[str], str]) – Expansions
space_fields (Union[List[str], str]) – space_fields
user_fields (Union[List[str], str]) – user_fields
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/spaces/lookup/api-reference/get-spaces-id
- Client.get_space_buyers(id, *, expansions, media_fields, place_fields, poll_fields, tweet_fields, user_fields)¶
지정한 스페이스의 유료 티켓 구매자 리스트를 반환합니다. 현재의 액세스 토큰으로 인증된 사용자가 만든 스페이스에만 사용 가능합니다.
버전 4.4에 추가.
- 매개변수
id (str) – 대상 스페이스의 ID값.
expansions (Union[List[str], str]) – Expansions
media_fields (Union[List[str], str]) – media_fields
place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/spaces/lookup/api-reference/get-spaces-id-buyers
- Client.get_space_tweets(id, *, expansions, media_fields, place_fields, poll_fields, tweet_fields, user_fields)¶
Returns Tweets shared in the requested Spaces.
버전 4.6에 추가.
- 매개변수
id (str) – Unique identifier of the Space containing the Tweets you’d like to access.
expansions (Union[List[str], str]) – Expansions
media_fields (Union[List[str], str]) – media_fields
place_fields (Union[List[str], str]) – place_fields
poll_fields (Union[List[str], str]) – poll_fields
tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/spaces/lookup/api-reference/get-spaces-id-tweets
리스트¶
리스트 트윗 자세히보기¶
- Client.get_list_tweets(id, *, expansions, max_results, pagination_token, tweet_fields, user_fields, user_auth=False)¶
지정한 리스트의 트윗 목록을 가져옵니다.
버전 4.4에 추가.
- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
리스트 구독(Follow)¶
- Client.unfollow_list(list_id, *, user_auth=True)¶
현재 인증된 사용자로서, 대상 리스트를 구독 해제합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_list_followers(id, *, expansions, max_results, pagination_token, tweet_fields, user_fields, user_auth=False)¶
지정한 리스트를 구독 중인 사람들의 리스트를 반환합니다.
버전 4.4에 추가.
- 매개변수
id (Union[List[str], str]) – 구독 중인 사람들의 리스트를 가져올 대상 리스트의 ID값.
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_followed_lists(id, *, expansions, list_fields, max_results, pagination_token, user_fields, user_auth=False)¶
지정한 사용자가 구독 중인 모든 리스트를 반환합니다.
버전 4.4에 추가.
- 매개변수
expansions (Union[List[str], str]) – Expansions
list_fields (Union[List[str], str]) – list_fields
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.follow_list(list_id, *, user_auth=True)¶
현재 인증된 사용자로서 대상 리스트를 구독(Follow)합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
리스트 자세히보기¶
- Client.get_list(id, *, expansions, list_fields, user_fields, user_auth=False)¶
지정한 하나의 리스트에 대한 다양한 정보를 반환합니다.
버전 4.4에 추가.
- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/lists/list-lookup/api-reference/get-lists-id
- Client.get_owned_lists(id, *, expansions, list_fields, max_results, pagination_token, user_fields, user_auth=False)¶
지정한 사용자가 소유 중인(만든) 모든 리스트를 반환합니다.
버전 4.4에 추가.
- 매개변수
expansions (Union[List[str], str]) – Expansions
list_fields (Union[List[str], str]) – list_fields
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
리스트 구성원¶
- Client.remove_list_member(id, user_id, *, user_auth=True)¶
현재 인증된 사용자로서, 지정한 사용자를 리스트 구성원에서 제거합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_list_members(id, *, expansions, max_results, pagination_token, tweet_fields, user_fields, user_auth=False)¶
지정한 리스트의 구성원 리스트를 반환합니다.
버전 4.4에 추가.
- 매개변수
expansions (Union[List[str], str]) – Expansions
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.tweet_fields (Union[List[str], str]) – tweet_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_list_memberships(id, *, expansions, list_fields, max_results, pagination_token, user_fields, user_auth=False)¶
지정한 사용자가 구성원인 모든 리스트를 반환합니다.
버전 4.4에 추가.
- 매개변수
id (Union[List[str], str]) – 지정한 대상이 구성원인 모든 리스트를 가져올 대상 사용자의 ID값.
expansions (Union[List[str], str]) – Expansions
list_fields (Union[List[str], str]) – list_fields
max_results (int) – 페이지당 반환받을 결과 수의 최댓값. 1에서 100 사이의 자연수로 지정해야 하며, 기본값은 100입니다. (페이지당 100개의 결과 반환)
pagination_token (str) – 다음 페이지나, 이전 페이지 결과값을 조회하는 데 쓰입니다. 바로 다음 페이지를 조회하려면 이전 요청에서 반환된
next_token
값을 전달하고, 바로 이전 페이지를 조회하려면 이전 요청에서 반환된previous_token
값을 전달하면 됩니다.user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.add_list_member(id, user_id, *, user_auth=True)¶
현재 인증된 사용자로서, 리스트에 구성원을 추가합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
리스트 관리¶
- Client.delete_list(id, *, user_auth=True)¶
현재 인증된 사용자로서, 소유 중인(만든) 리스트를 삭제합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/lists/manage-lists/api-reference/delete-lists-id
- Client.update_list(id, *, description=None, name=None, private=None, user_auth=True)¶
현재 인증된 사용자로서, 소유 중인(만든) 리스트의 메타데이터를 수정합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/lists/manage-lists/api-reference/put-lists-id
- Client.create_list(name, *, description=None, private=None, user_auth=True)¶
현재 인증된 사용자로서 리스트를 만들 수 있도록 합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
https://developer.twitter.com/en/docs/twitter-api/lists/manage-lists/api-reference/post-lists
리스트 고정¶
- Client.unpin_list(list_id, *, user_auth=True)¶
현재 인증된 사용자로서 리스트를 고정 해제(Unpin)합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_pinned_lists(*, expansions, list_fields, user_fields, user_auth=True)¶
지정한 사용자가 고정한 리스트를 반환합니다.
버전 4.4에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
expansions (Union[List[str], str]) – Expansions
list_fields (Union[List[str], str]) – list_fields
user_fields (Union[List[str], str]) – user_fields
user_auth (bool) – Whether or not to use OAuth 1.0a User Context to authenticate
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.pin_list(list_id, *, user_auth=True)¶
현재 인증된 사용자로서 리스트를 고정(Pin)합니다.
버전 4.2에 추가.
버전 4.5에서 변경: Added
user_auth
parameter- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
표준 작업(Compliance)¶
표준 준수 하 일괄 작업(Batch compliance)¶
- Client.get_compliance_jobs(type, *, status)¶
최근 표준 작업의 리스트를 반환합니다.
버전 4.1에 추가.
- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.get_compliance_job(id)¶
ID값으로 지정한 하나의 표준 작업을 가져옵니다.
버전 4.1에 추가.
- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
- Client.create_compliance_job(type, *, name=None, resumable=None)¶
특정 트윗 ID 또는 사용자 ID에 대해 새 표준 작업을 만듭니다.
표준 작업에는 고유 ID값과 경로 URL이 포함됩니다. 경로 URL은 앱에서 사용하는 ID 목록이 포함된 위치를 가리킵니다.
한 번에 하나의 일괄 작업만 실행할 수 있습니다.
버전 4.1에 추가.
- 매개변수
- 반환값
- 반환 형식
Union[dict, requests.Response, Response]
참조
확장 및 필드 매개변수¶
Expansions
¶
확장(Expansions) 을 사용해, 반환받은 리스트, 스페이스, 트윗 및 사용자와 관련된 추가 데이터 객체를 요청할 수 있습니다. 공백 문자 없이 쉼표(,)로 구분된 목록 꼴로 사용할 확장(Expansions)을 전달하시기 바랍니다. 확장 데이터 객체를 나타내는 ID는 리스트, 스페이스, 트윗 및 사용자에 포함되지만, 해당 데이터 객체의 메타데이터는 전달받은 includes
객체에 포함됩니다. 더불어 확장 데이터 객체를 받을 때, 리스트, 스페이스 트윗 및 사용자에 포함된 데이터와 비교할 수 있도록 ID값도 같이 받게 됩니다.
이 때, 리스트 개체를 주로 반환하는 엔드포인트에서 사용할 수 있는 유일한 확장(Expansions)은 expansions=owner_id
입니다. 확장 사용자 데이터 객체는 includes
객체에서 찾을 수 있습니다.
스페이스를 반환하는 메서드는, 다음 데이터 객체를 이 매개변수를 활용해 확장할 수 있습니다.
스페이스 개설자인 사용자의 객체
스페이스의 공동 개설자인 아무 사용자의 객체
멘션된 아무 사용자의 객체
발언자인 아무 사용자의 객체
트윗을 반환하는 메서드는, 다음 데이터 객체를 이 매개변수를 활용해 확장할 수 있습니다.
트윗 작성자인 사용자의 객체
해당 트윗이 답글을 보내고 있는 트윗의 작성자인 사용자의 객체
멘션된 아무 사용자의 객체
참조하고 있는 트윗(Referenced Tweets)의 작성자인 아무 사용자의 객체
첨부된 미디어의 객체
첨부된 투표의 객체
첨부된 장소의 객체
아무 참조하고 있는 트윗(Referenced Tweets)의 객체
이 때, 사용자 개체를 주로 반환하는 엔드포인트에서 사용할 수 있는 유일한 확장(Expansions)은 expansions=pinned_tweet_id
입니다. 확장 트윗 데이터 객체는 includes
객체에서 찾을 수 있습니다.
list_fields
¶
이 필드(fields) 매개변수를 사용하면 어떤 리스트 필드(List fields) 가 각 리스트 객체마다 같이 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. 지정한 리스트 필드는 리스트 데이터 객체에 직접 표시됩니다.
media_fields
¶
이 필드(fields) 매개변수를 사용하면 어떤 미디어 필드(Media fields) 가 각 트윗마다 같이 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. 단, 트윗에 미디어가 첨부되어 있어야 하며, 동시에 expansions=attachments.media_keys
쿼리 매개변수를 요청에 같이 포함시켜야 합니다. 그래야 미디어 필드를 반환할 것입니다. 미디어 ID값은 트윗 객체에 위치하나, includes
데이터 객체에는 이 ID값과 모든 추가 미디어 필드가 포함됩니다.
place_fields
¶
이 필드(fields) 매개변수를 사용하면 어떤 장소 필드(Place fields) 가 각 트윗마다 같이 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. 단, 트윗에 특정 장소가 첨부되어 있어야 하며, expansions=geo.place_id
쿼리 매개변수를 요청에 같이 포함시켜야 합니다. 그래야 장소 필드를 반환할 것입니다. 장소 ID값은 트윗 객체에 위치하나, includes
데이터 객체에는 이 ID값과 모든 추가 장소 필드가 포함됩니다.
poll_fields
¶
이 필드(fields) 매개변수를 사용하면 어떤 투표 필드(Place fields) 가 각 트윗마다 같이 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. 단, 트윗에 투표가 첨부되어 있어야 하며, expansions=attachments.poll_ids
쿼리 매개변수를 요청에 같이 포함시켜야 합니다. 그래야 투표 필드를 반환할 것입니다. 투표 ID값은 트윗 객체에 위치하나, includes
데이터 객체에는 이 ID값과 모든 추가 투표 필드가 포함됩니다.
space_fields
¶
이 필드(fields) 매개변수를 사용하면 어떤 스페이스 필드(Space fields) 가 각 스페이스마다 같이 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다.
tweet_fields
¶
트윗을 반환하는 메서드는, 이 필드(fields) 매개변수를 사용하면 어떤 트윗 필드(Tweet fields) 가 각 트윗 객체마다 같이 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. expansions=referenced_tweets.id
확장(Expansion)을 전달해 지정한 필드들이 원본 트윗과 아무 참조하고 있는 트윗(Referenced Tweet) 모두에서 반환되게 할 수 있습니다. 요청한 트윗의 필드는 원본 트윗 데이터 객체와, includes
데이터 객체에 위치하는 참조하고 있는 트윗 확장 데이터 객체에 직접 표시됩니다.
사용자를 반환하는 메서드는, 이 필드(fields) 매개변수를 사용하면 어떤 트윗 필드(Tweet fields) 가 각 고정된(Pinned, 〈프로필 메인에 올리기’를 의미) 트윗마다 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. 트윗 필드는 사용자가 고정된 트윗을 갖고 있고, 동시에 요청에 expansions=pinned_tweet_id
쿼리 매개변수를 포함한 경우에만 반환됩니다.참조하고 있는 트윗의 ID값은 원본 트윗 객체에 위치하나, includes
데이터 객체에는 이 ID값과 모든 추가 트윗 필드가 포함됩니다.
user_fields
¶
스페이스나 트윗을 반환하는 메서드는, 이 필드(fields) 매개변수를 사용하면 어떤 사용자 필드(User fields) 가 각 트윗 또는 스페이스마다 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. 사용자 ID값은 원본 트윗 객체에 위치하나, includes
데이터 객체에는 이 ID값과 모든 추가 사용자 필드가 포함됩니다.
원하는 사용자 필드를 반환받으려면, 다음 사용자 확장(Expansions)을 같이 전달해야 합니다:
expansions=author_id
expansions=entities.mentions.username
expansions=in_reply_to_user_id
expansions=referenced_tweets.id.author_id
사용자를 반환하는 메서드는, 이 필드(fields) 매개변수를 사용하면 어떤 사용자 필드(User fields) 가 각 사용자 객체마다 반환될지를 지정할 수 있습니다. 같이 반환받을 필드를 쉼표(,)로 구분하고 있고, 공백 문자가 없는 리스트 형식으로 지정 및 전달하면 됩니다. 지정한 사용자 필드는 사용자 데이터 객체에 직접 표시됩니다.