API Hop दस्तावेज़
उपयोगकर्ता टाइमलाइन पाएँ
उपयोगकर्ता ID से Twitter टाइमलाइन क्वेरी करें और मानकीकृत ट्वीट, लेखक विस्तार तथा पृष्ठांकन मेटाडेटा पाएँ।
https://api.apihop.ai/v1/twitter/users/{id}/tweetsमानकीकृत उपयोगकर्ता ID से उसकी टाइमलाइन क्वेरी करें। एंडपॉइंट X API v2-शैली data / includes / meta संरचनाएँ लौटाता है।
GET https://api.apihop.ai/v1/twitter/users/{id}/tweetsप्रमाणीकरण
सभी Twitter API एंडपॉइंट में Bearer Token प्रमाणीकरण आवश्यक है।
Authorization: Bearer YOUR_API_KEYपथ पैरामीटर
idstringआवश्यकTwitter उपयोगकर्ता ID, जैसे 44196397।
क्वेरी पैरामीटर
max_resultsintegerडिफ़ॉल्ट: 10एक पृष्ठ में लौटाने वाले ट्वीट की संख्या, 1 से 100 तक।
pagination_tokenstringअगले पृष्ठ का कर्सर, पिछले उत्तर के meta.next_token से कॉपी किया हुआ।
excludestringकॉमा से अलग बहिष्करण नीति। समर्थित मान replies और retweets हैं।
expansionsstringकॉमा से अलग विस्तार फ़ील्ड। includes.users शामिल करने के लिए author_id लें।
tweet.fieldsstringकॉमा से अलग ट्वीट फ़ील्ड, जैसे created_at,public_metrics,attachments,source।
user.fieldsstringexpansions=author_id माँगने पर includes.users के फ़ील्ड नियंत्रित करता है।
अनुरोध उदाहरण
curl --request GET \
"$API_BASE_URL/v1/twitter/users/44196397/tweets?max_results=5&exclude=retweets,replies&expansions=author_id&tweet.fields=created_at,public_metrics,attachments,author_id,conversation_id&user.fields=public_metrics" \
--header "Authorization: Bearer YOUR_API_KEY"उत्तर
dataobject[]आवश्यकटाइमलाइन ट्वीट सूची।
ट्वीट फ़ील्ड
idstringआवश्यकट्वीट ID।
textstringआवश्यकट्वीट की टेक्स्ट सामग्री।
attachmentsobjectमीडिया संदर्भ, फिलहाल media_keys के रूप में लौटते हैं।
author_idstringलेखक ID। expansions=author_id माँगने पर यह includes.users से मेल खाती है।
conversation_idstringबातचीत ID।
created_atstringISO 8601 प्रारूप में ट्वीट निर्माण समय।
edit_history_tweet_idsstring[]संपादन इतिहास की ट्वीट ID।
entitiesobjectपार्स की गई ट्वीट इकाइयाँ, जैसे हैशटैग, URL और उल्लेख।
in_reply_to_user_idstringजिस उपयोगकर्ता को उत्तर दिया जा रहा है उसकी ID।
langstringट्वीट की भाषा।
possibly_sensitivebooleanसामग्री संवेदनशील है या नहीं।
public_metricsobjectसार्वजनिक ट्वीट आँकड़े।
public_metrics फ़ील्ड
retweet_countintegerरीट्वीट संख्या।
reply_countintegerउत्तर संख्या।
like_countintegerपसंद संख्या।
quote_countintegerउद्धरण संख्या।
bookmark_countintegerबुकमार्क संख्या।
impression_countintegerइम्प्रेशन संख्या।
referenced_tweetsobject[]संदर्भित ट्वीट। type में retweeted, quoted या replied_to हो सकता है।
sourcestringट्वीट स्रोत, जैसे क्लाइंट या वेब।
includesobjectविस्तारित ऑब्जेक्ट। expansions में author_id होने पर दिखते हैं।
includes फ़ील्ड
usersobject[]author_id से संबंधित लेखक सूची।
metaobjectआवश्यकपृष्ठांकन और परिणाम मेटाडेटा।
meta फ़ील्ड
newest_idstringवर्तमान पृष्ठ की सबसे नई ट्वीट ID।
oldest_idstringवर्तमान पृष्ठ की सबसे पुरानी ट्वीट ID।
next_tokenstringअगले पृष्ठ का कर्सर। इसे pagination_token में भेजें।
result_countintegerआवश्यकवर्तमान पृष्ठ में ट्वीट की संख्या।
सफलता उदाहरण
{
"data": [
{
"id": "tweet-1",
"text": "Hello Mars",
"author_id": "44196397",
"created_at": "2025-04-22T10:00:00.000Z",
"public_metrics": {
"retweet_count": 3,
"reply_count": 2,
"like_count": 7
}
}
],
"includes": {
"users": [
{
"id": "44196397",
"name": "Elon Musk",
"username": "elonmusk"
}
]
},
"meta": {
"newest_id": "tweet-1",
"oldest_id": "tweet-1",
"next_token": "cursor-123",
"result_count": 1
}
}त्रुटि उत्तर
पूरी कोड सूची, प्रोटोकॉल अंतर और निदान चरणों के लिए त्रुटि कोड और निदान देखें।
{
"success": false,
"error": {
"code": 40000,
"message": "Insufficient credit. Required: 100000, Available: 99999"
},
"requestId": "req_xxx"
}पृष्ठांकन
meta.next_token मौजूद हो तो अगला पृष्ठ पाने के लिए उसे pagination_token में दें।