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