Felo X उपयोगकर्ता प्रोफ़ाइल
Provider: Felo · भुगतान platform balance से
आपको जिस डेटा की आवश्यकता है, उसके लिए उपयुक्त operation चुनें। सभी पाँच endpoints POST का उपयोग करते हैं और root पर JSON लौटाते हैं, बिना किसी shared data wrapper के।
सभी examples overview से FELO_API_KEY का उपयोग करते हैं। Calls platform balance का उपयोग करती हैं, Felo Pro credits का नहीं। Response examples केवल illustrative हैं; live content और optional fields बदलते रहते हैं।
1. उपयोगकर्ता प्रोफ़ाइल प्राप्त करें
POST /api/v1/data/x/user/info
| फ़ील्ड | प्रकार | आवश्यक | अर्थ |
|---|---|---|---|
usernames | स्ट्रिंग सरणी | हाँ | 1–100 उपयोगकर्ता नाम; हैंडल @ के बिना भेजें |
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/info" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["OpenAI"]}'Response में users और total होते हैं। प्रत्येक user में user_id, username और display_name शामिल होते हैं; profile text, follower counts, verification और अन्य metadata भी मौजूद हो सकती है। एक batch request किए गए profiles से कम profiles लौटा सकता है। Match username या ID से करें, array position से नहीं।
{"users":[{"user_id":"example-user-id","username":"example","display_name":"Example"}],"total":1}पृष्ठांकन और लागत नियंत्रण
total वर्तमान response में संबंधित array को count करता है: post queries के लिए top-level posts, या reply queries के लिए प्रत्येक result entry के भीतर replies। यह global match count, किसी post की complete reply count, या अंतिम billable count नहीं है।
- पहली request
cursorके बिना भेजें। - Response से
has_nextऔरnext_cursorपढ़ें। Replies के लिए, उन्हें प्रत्येक result entry पर पढ़ें। - यदि कोई और page मौजूद है और cursor nonempty है, तो उसी query के साथ उसे बिना बदले भेजें। Replies batch के लिए, प्रत्येक post को अलग-अलग जारी रखें।
- जब next page न हो, cursor दोहराया जाए, या आपकी अपनी page अथवा spending limit पूरी हो जाए, तब रुकें।
Pagination metadata अंतिम upstream response को दर्शाती है; returned collection result cap पर truncate हो सकती है। यहाँ तक कि has_next=false भी इस बात की गारंटी नहीं है कि पूरा X history या replies प्राप्त कर लिए गए हैं। Bounded result set को all available data कहने के बजाय actual returned count दिखाएँ।
हर successful page पर charge लग सकता है। ये पाँच operations flat request fee से नहीं, बल्कि returned results के अनुसार billed होती हैं। Nested replies और अन्य returned records billed count को प्रभावित कर सकते हैं; केवल top-level array length से cost का अनुमान न लगाएँ। current prices और console में usage जाँचें। Complete object fields OpenAPI schema में हैं।