API Hop दस्तावेज़
उपयोगकर्ता नाम से उपयोगकर्ता पाएँ
उपयोगकर्ता नाम से Twitter प्रोफ़ाइल क्वेरी करें और मानकीकृत X API v2-शैली उपयोगकर्ता ऑब्जेक्ट पाएँ।
https://api.apihop.ai/v1/twitter/usersप्रोफ़ाइल क्वेरी के लिए username लें। केवल उपयोगकर्ता नाम मालूम हो और टाइमलाइन अनुरोध के लिए मानकीकृत data.id चाहिए तो यह एंडपॉइंट उपयोगी है।
GET https://api.apihop.ai/v1/twitter/usersप्रमाणीकरण
सभी Twitter API एंडपॉइंट में Bearer Token प्रमाणीकरण आवश्यक है।
Authorization: Bearer YOUR_API_KEYक्वेरी पैरामीटर
usernamestringआवश्यकTwitter उपयोगकर्ता नाम। elonmusk और @elonmusk दोनों स्वीकार हैं; शुरुआती @ सर्वर पर हटता है।
user.fieldsstringकॉमा से अलग उपयोगकर्ता फ़ील्ड, जैसे created_at,description,public_metrics,verified।
अनुरोध उदाहरण
curl --request GET \
"$API_BASE_URL/v1/twitter/users?username=elonmusk&user.fields=created_at,description,public_metrics,verified" \
--header "Authorization: Bearer YOUR_API_KEY"उत्तर
dataobjectआवश्यकमानकीकृत उपयोगकर्ता ऑब्जेक्ट।
data फ़ील्ड
idstringआवश्यकउपयोगकर्ता की अद्वितीय पहचान। टाइमलाइन क्वेरी में इस मान को प्राथमिकता दें।
namestringआवश्यकप्रदर्शन नाम।
usernamestringआवश्यक@ के बिना उपयोगकर्ता नाम।
created_atstringISO 8601 टाइमस्टैम्प, user.fields=created_at माँगने पर लौटता है।
descriptionstringउपयोगकर्ता परिचय।
entitiesobjectप्रोफ़ाइल इकाइयाँ, जैसे URL विवरण और लिंक।
locationstringउपयोगकर्ता प्रोफ़ाइल का स्थान।
pinned_tweet_idstringपिन किए ट्वीट की ID।
profile_banner_urlstringप्रोफ़ाइल बैनर URL।
profile_image_urlstringप्रोफ़ाइल चित्र URL।
protectedbooleanखाता संरक्षित है या नहीं।
public_metricsobjectसार्वजनिक उपयोगकर्ता आँकड़े।
public_metrics फ़ील्ड
followers_countintegerफ़ॉलोअर संख्या।
following_countintegerफ़ॉलो किए खातों की संख्या।
tweet_countintegerट्वीट की कुल संख्या।
listed_countintegerउपयोगकर्ता को शामिल करने वाली सूचियों की संख्या। डेटा स्रोत न दे तो अनुपस्थित हो सकती है।
urlstringउपयोगकर्ता प्रोफ़ाइल का वेबसाइट URL।
verifiedbooleanखाता सत्यापित है या नहीं।
verified_typestringसत्यापन प्रकार, जैसे Business।
सफलता उदाहरण
{
"data": {
"id": "44196397",
"name": "Elon Musk",
"username": "elonmusk",
"created_at": "2009-06-02T20:12:29.000Z",
"description": "Mars and cars",
"public_metrics": {
"followers_count": 10,
"following_count": 20,
"tweet_count": 40
},
"verified": true
}
}त्रुटि उत्तर
पूरी कोड सूची, प्रोटोकॉल अंतर और निदान चरणों के लिए त्रुटि कोड और निदान देखें।
{
"success": false,
"error": {
"code": 40000,
"message": "Insufficient credit. Required: 100000, Available: 99999"
},
"requestId": "req_xxx"
}उपयोग सुझाव
- केवल
usernameपता हो तो पहले यह एंडपॉइंट कॉल करें - टाइमलाइन क्वेरी करनी हो तो लौटी
data.idलें - केवल अवतार, परिचय या फ़ॉलोअर संख्या चाहिए तो स्पष्ट
user.fieldsदें