本系列是對推特開發(fā)者文檔進(jìn)行的翻譯,以便幫助開發(fā)人員使用API接口,難免有些地方存在不足,還請諒解。
V1.1中搜索接口是search/tweets和Labs的rencent search,但是在V2中都被合并成一個了。
Twitter API v2最近的搜索端點為開發(fā)人員提供了對上周發(fā)布的公共Tweet的API訪問權(quán)限。終結(jié)點,接收單個搜索查詢并以匹配的Tweet響應(yīng)。最近的搜索端點可用于各種各樣的用例。從提供基礎(chǔ)研究數(shù)據(jù)到近乎實時的“監(jiān)聽”應(yīng)用程序,此端點可用于收集與感興趣主題相關(guān)的推文。
該RESTful終結(jié)點可以按逆序排列的順序?qū)⒚總€請求傳遞到100條Tweets,并且提供分頁令牌以通過大量匹配的Tweets進(jìn)行分頁。搜索查詢是使用與Tweet和用戶屬性(例如,消息關(guān)鍵字,主題標(biāo)簽和URL)匹配的運算符創(chuàng)建的。運算符和規(guī)則子句可以結(jié)合到具有布爾邏輯和括號的查詢中,以幫助優(yōu)化過濾器的匹配行為,該行為最多可以增加512個字符。
Search Tweets支持按時間和Tweet ID范圍瀏覽Tweet存檔。它旨在支持兩種常見的用例:
“獲取歷史記錄”:請求的期限是一個感興趣的時間,而不關(guān)注數(shù)據(jù)的實時性。發(fā)出單個請求,并根據(jù)需要使用分頁傳遞所有匹配的數(shù)據(jù)。這是搜索推文的默認(rèn)模式。
"Polling"or"listening":在“自上次請求以來是否有任何新推文中進(jìn)行了請求?”模式。請求是連續(xù)進(jìn)行的,通常會有一個用例集中關(guān)注感興趣的推文的近實時“監(jiān)聽”。
Twitter API v2引入了以下功能:
·Tweet屬性將包括有關(guān)Tweet消息中事物和主題的Twitter注釋。有兩個新的運算符,使您可以匹配實體和上下文注釋。
·使用talking_id Tweet屬性可以更輕松地將對話線程化。還可以使用新的session_id運算符在Twitter上的對話中的推文上進(jìn)行匹配。
·使用字段request參數(shù)選擇感興趣的特定Tweet,用戶,媒體,民意測驗或地理對象屬性。
·在擴(kuò)展參數(shù)中包含相關(guān)對象。例如,如果要求使用相應(yīng)的tweet.fields參數(shù),Tweets可以包括用戶的author_id。如果您包含expandations=author_id參數(shù),則可以請求其他用戶字段,例如他們的個人描述或固定的推文。
端點網(wǎng)址:
https://api.twitter.com/2/tweets/search/recent
速率是450個請求/15分鐘
具體參數(shù)見下圖