`AsyncStream`

class tweepy.asynchronous.AsyncStream(consumer_key, consumer_secret, access_token, access_token_secret, *, max_retries=inf, proxy=None)

Stream realtime Tweets asynchronously with Twitter API v1.1

참고

New Twitter Developer Apps created on or after April 29, 2022 will not be able to gain access to v1.1 statuses/sample and v1.1 statuses/filter, the Twitter API v1.1 endpoints that AsyncStream uses. Twitter API v2 can be used instead with AsyncStreamingClient.

버전 4.0에 추가.

매개변수

consumer_key (str) – 트위터 API Consumer Key값
consumer_secret (str) – 트위터 API Consumer Secret값
access_token (str) – Twitter API 액세스 토큰
access_token_secret (str) – Twitter API 액세스 토큰 Secret값
max_retries (int | None) – 스트림에 (재)연결 시도할 횟수.
proxy (str | None) – URL of the proxy to use when connecting to the stream

session

API와의 연결에 사용될 Aiohttp 클라이언트 세션.

형식: aiohttp.ClientSession | None

task

스트림 실행 중인 작업.

형식: asyncio.Task | None

user_agent

API 연결에 사용되는 사용자 에이전트(User agent).

형식: str

filter(*, follow=None, track=None, locations=None, filter_level=None, languages=None, stall_warnings=False)

실시간으로 트윗을 필터링합니다.

버전 4.10부터 폐지됨: The delivery of compliance messages through the Twitter API v1.1 endpoint this method uses has been deprecated, and they will stop being delivered beginning October 29, 2022. Twitter API v2 can be used instead with AsyncStreamingClient.filter() and/or AsyncClient batch compliance methods.

매개변수

follow (list[int | str] | None) – 스트림에 트윗(Status)들을 포함시킬 대상 사용자의 ID값 리스트. 자세한 정보는 다음 URL을 참고하시기 바랍니다. https://developer.twitter.com/en/docs/twitter-api/v1/tweets/filter-realtime/guides/basic-stream-parameters
track (list[str] | None) – 검색·추적할 키워드. 키워드 구문의 리스트꼴로 지정해야 합니다.자세한 정보는 다음 URL을 참고하시기 바랍니다. https://developer.twitter.com/en/docs/tweets/filter-realtime/guides/basic-stream-parameters
locations (list[float] | None) – 검색·추적할 위치를 지정하는 경계 상자(Bounding box)의 집합.자세한 정보는 다음 URL을 참고하시기 바랍니다. https://developer.twitter.com/en/docs/tweets/filter-realtime/guides/basic-stream-parameters for more information.
filter_level (str | None) – 이 매개변수를 none, low 또는 medium 중 하나로 설정하면 스트림에 포함해야 하는 트윗 속성 중 filter_level 속성의 최솟값을 정합니다. 기본값은 none이며, 이는 모든 사용 가능한 트윗을 스트림에 포함합니다. 스트림의 트윗을 엔드유저(예: 프레젠테이션, 컨퍼런스의 대시보드 또는 라이브 피드)에게 트윗 스트림을 표시해야 할 때는, 이 값을 medium으로 설정하는 것을 권장합니다.
languages (list[str] | None) – 이 매개변수를 BCP 47 언어 식별자꼴로 표현되는, 쉼표(,)로 구분된 리스트로 설정하면(단, 트위터의 고급 검색 페이지에 있는 언어에 한함) 지정한 언어로 작성된 트윗만 반환합니다. 예로, language=ko 로 설정하면 한국어로 작성된 트윗만 스트림에 포함됩니다.
stall_warnings (bool | None) – 지연 경고(Stall warnings)를 전달할지의 여부.자세한 정보는 다음 URL을 참고하시기 바랍니다. https://developer.twitter.com/en/docs/tweets/filter-realtime/guides/basic-stream-parameters for more information.

예외 발생

TweepyException – 위치 좌표 수가 4의 배수가 아닌 경우

반환값

스트림 실행 중인 작업.

반환 형식

asyncio.Task

참조

https://developer.twitter.com/en/docs/twitter-api/v1/tweets/filter-realtime/api-reference/post-statuses-filter

sample(*, languages=None, stall_warnings=False)

실시간으로 트윗을 샘플링합니다.

버전 4.10부터 폐지됨: The Twitter API v1.1 endpoint this method uses is now deprecated and will be retired on October 29, 2022. Twitter API v2 can be used instead with AsyncStreamingClient.sample().

매개변수

languages (list[str] | None) – 이 매개변수를 BCP 47 언어 식별자꼴로 표현되는, 쉼표(,)로 구분된 리스트로 설정하면(단, 트위터의 고급 검색 페이지에 있는 언어에 한함) 지정한 언어로 작성된 트윗만 반환합니다. 예로, language=ko 로 설정하면 한국어로 작성된 트윗만 스트림에 포함됩니다.
stall_warnings (bool | None) – 지연 경고(Stall warnings)를 전달할지의 여부.자세한 정보는 다음 URL을 참고하시기 바랍니다. https://developer.twitter.com/en/docs/tweets/filter-realtime/guides/basic-stream-parameters for more information.

예외 발생

TweepyException – 스트림이 이미 연결되어있는 경우

반환값

스트림 실행 중인 작업.

반환 형식

asyncio.Task

참조

https://developer.twitter.com/en/docs/twitter-api/v1/tweets/sample-realtime/api-reference/get-statuses-sample

async on_data(raw_data)