उपयोगकर्ता नाम से खाता खोजें और लौटाए जाने वाले प्रोफ़ाइल फ़ील्ड चुनें।
Twitter API
Twitter API: उपयोगकर्ता खोज, टाइमलाइन और पेजिनेशन
Bearer प्रमाणीकरण, उपयोगकर्ता और ट्वीट फ़ील्ड चयन, कर्सर पेजिनेशन तथा सत्यापन त्रुटि प्रबंधन के साथ API Hop Twitter / X एंडपॉइंट जोड़ें।
उपयोगकर्ता नाम से उपयोगकर्ता ID निकालें, उसकी टाइमलाइन प्राप्त करें और अगला पेज माँगने के लिए लौटाया गया अगला टोकन भेजें। सफल कॉल सीधे JSON लौटाती हैं; इन एंडपॉइंट के लिए Jobs पोलिंग का चरण नहीं है।
विशिष्ट कार्य के लिए बना
तीनों समर्थित GET ऑपरेशन लागू करें और उनके परिणाम सँभालें।
उपयोगकर्ता नाम फिर से खोजे बिना ज्ञात खाते को उपयोगकर्ता ID से रीफ़्रेश करें।
पेज आकार सीमा और पेजिनेशन टोकन के साथ टाइमलाइन पेज प्राप्त करें।
बिलिंग इकाई
जानें कि उपयोग कैसे मापा जाता है
प्रति अनुरोध USD।
संचालन की सीमाएँ
- लौटाए गए फ़ील्ड दस्तावेज़ में दिए क्वेरी पैरामीटर और अपस्ट्रीम प्रतिक्रिया पर निर्भर करते हैं।
- max_results को 1 से 100 तक पूर्णांक होना चाहिए। एक पेज में कम परिणाम हो सकते हैं।
- संख्यात्मक सटीकता की हानि से बचने के लिए उपयोगकर्ता ID और ट्वीट ID स्ट्रिंग के रूप में रखें।
इंटीग्रेशन गाइड
अपना अगला कदम चुनें
मौजूदा कैटलॉग कवरेज
उपलब्ध API और बिलिंग इकाइयाँ
API ID, ऑपरेशन, प्रदाताओं और मूल्य की तुलना करें। उपयोग लागत का अनुमान लगाने से पहले कैटलॉग की तारीख और हर ऑपरेशन की बिलिंग इकाई जाँचें।
Twitter / X की सार्वजनिक प्रोफ़ाइल और उपयोगकर्ता टाइमलाइन प्राप्त करें।
- प्रदाता
- Twitter / X Data
- बिलिंग इकाई
- अनुरोध
- API प्रारूप और एंडपॉइंट
- अनुरोध एंडपॉइंट के लिए नीचे दिए गए ऑपरेशन देखें।
- प्रकाशित क्षमताएँ
- उपयोगकर्ता खोज, उपयोगकर्ता टाइमलाइन
प्रकाशित ऑपरेशन
-
GET /v1/twitter/usersउपयोगकर्ता नाम से उपयोगकर्ता प्राप्त करें -
GET /v1/twitter/users/{id}ID से उपयोगकर्ता प्राप्त करें -
GET /v1/twitter/users/{id}/tweetsउपयोगकर्ता की पोस्ट प्राप्त करें
API Hop मूल्य
- अनुरोध
- $0.0020 /अनुरोध
उपयोगकर्ता नाम से उपयोगकर्ता प्राप्त करें
GET /v1/twitter/users API Hop मूल्य
- अनुरोध
- $0.0020 /अनुरोध
ID से उपयोगकर्ता प्राप्त करें
GET /v1/twitter/users/{id} API Hop मूल्य
- अनुरोध
- $0.0020 /अनुरोध
उपयोगकर्ता की पोस्ट प्राप्त करें
GET /v1/twitter/users/{id}/tweets API Hop मूल्य
- अनुरोध
- $0.0020 /अनुरोध
अनुरोध उदाहरण
दस्तावेज़ में दिए ऑपरेशन से शुरू करें
curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
-H "Authorization: Bearer <API_KEY>"const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);import requests
url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())खाते के दस्तावेज़ वाला API बेस URL इस्तेमाल करें और उदाहरण के प्लेसहोल्डर बदलें। API कुंजी Authorization हेडर में भेजें; उसे कभी URL या कमिट की गई फ़ाइल में न डालें।
एंडपॉइंट
खातों और टाइमलाइन के लिए तीन ऑपरेशन
GET /v1/twitter/users?username=<USERNAME> आगे के अनुरोधों के लिए लौटाए गए data.id को स्ट्रिंग के रूप में पढ़ें।
GET /v1/twitter/users/<USER_ID> ज्ञात खाता प्राप्त करें और आवश्यकता के अनुसार उसके प्रोफ़ाइल फ़ील्ड चुनें।
GET /v1/twitter/users/<USER_ID>/tweets max_results सेट करें और आगे के पेज के लिए pagination_token भेजें।
क्वेरी पैरामीटर
फ़ील्ड चुनें और टाइमलाइन को पेज में बाँटें
- खाता खोज
/v1/twitter/usersपरusernameआवश्यक है। दोनों खोज एंडपॉइंट अल्पविराम से अलग की गईuser.fieldsसूची स्वीकार करते हैं, जैसेdescription,public_metrics।- पेज का आकार
max_results1 से 100 तक पूर्णांक स्वीकार करता है। यह पेज के आकार की ऊपरी सीमा है, उतनी पोस्ट की गारंटी नहीं।- टाइमलाइन फ़ील्ड
- समय और मेट्रिक के लिए
tweet.fields=created_at,public_metricsइस्तेमाल करें। उपलब्ध लेखक विवरण चाहिए तोuser.fieldsके साथexpansions=author_idमाँगें। उन पोस्ट प्रकारों को हटाने के लिएexclude=replies,retweetsइस्तेमाल करें। - अगला पेज
- प्रतिक्रिया के
meta.next_tokenको अगले अनुरोध मेंpagination_tokenके रूप में भेजें। टोकन की व्याख्या न करें और उसे URL-एन्कोड करें। अगला टोकन न लौटने, पेज बजट पूरा होने या टोकन दोहराने पर रुकें।
प्रतिक्रिया प्रबंधन
JSON परिणाम सीधे पढ़ें
उपयोगकर्ता खोज खाते को data में लौटाती है। टाइमलाइन प्रतिक्रियाओं में data ऐरे और meta.result_count होते हैं, तथा अगला कर्सर उपलब्ध होने पर meta.next_token होता है। लेखक की विस्तृत जानकारी includes.users में आ सकती है।
{
"data": [],
"meta": {
"result_count": 0
}
}यह खाली टाइमलाइन प्रतिक्रिया का उदाहरण है, किसी खाते का वास्तविक परिणाम नहीं। वैकल्पिक फ़ील्ड और कर्सर अनुपस्थित हो सकते हैं। खाली पेज इस बात का प्रमाण नहीं कि खाते ने कभी पोस्ट नहीं की।
सत्यापन त्रुटियाँ
पुनः प्रयास से पहले अमान्य पैरामीटर सुधारें
username गुम होने या max_results सीमा से बाहर होने पर HTTP 400 के साथ success: false, error.code: 10001, error.message और requestId लौटते हैं। बिना बदलाव दोबारा भेजने के बजाय संदेश पढ़कर अनुरोध सुधारें।
अनुरोध ट्रेसिंग
अनुरोध ID रखें, क्रेडेंशियल नहीं
सहायता और अनुरोध ट्रेसिंग के लिए X-Request-Id प्रतिक्रिया हेडर रखें। सफल पेलोड पढ़ने से पहले HTTP स्थिति जाँचें और API कुंजियाँ तथा गैरज़रूरी प्रोफ़ाइल डेटा एप्लिकेशन लॉग में न रखें।