Felo APIs

X Search API

X उपयोगकर्ता, tweets, टाइमलाइन और जवाब खोजें और पेजिनेशन मेटाडेटा पाएं।

POST/v2/x/tweet/search

प्रमाणीकरण

Bearer API key

कंटेंट टाइप

application/json

दर संबंधी नोट

1 request per 10 seconds, 3 per minute, 10 per 10 minutes.

Chat API

X Search API X (Twitter) डेटा तक पहुंच देती है, जिसमें उपयोगकर्ता प्रोफ़ाइल, ट्वीट खोज, उपयोगकर्ता ट्वीट और ट्वीट रिप्लाई शामिल हैं।

प्रमाणीकरण

सभी अनुरोधों के लिए Authorization हेडर में API Key ज़रूरी है:

Authorization: Bearer YOUR_API_KEY

AI Agent के साथ उपयोग करें

Agent को X Search और हर अन्य उपलब्ध Felo Skill देने के लिए पूरा felo-ai पैकेज इंस्टॉल करें। इंस्टॉलर स्थिर Skill सूची रखने के बजाय SKILL.md वाली हर पैकेज डायरेक्टरी को गतिशील रूप से खोजता है। सभी खोजी गई Skills को Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills या Hermes Agent ~/.hermes/skills में इंस्टॉल करें। प्लेटफ़ॉर्म-विशिष्ट इंस्टॉलेशन, API key और सत्यापन निर्देशों के लिए मैन्युअल AI Agent सेटअप गाइड देखें।

1. उपयोगकर्ता जानकारी प्राप्त करें

उपयोगकर्ता नाम से X उपयोगकर्ता प्रोफ़ाइल बैच में प्राप्त करें।

Endpoint

POST https://openapi.felo.ai/v2/x/user/info

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
`usernames`	array of strings	हां	खोजने के लिए X उपयोगकर्ता नाम की सूची

उदाहरण

curl -X POST 'https://openapi.felo.ai/v2/x/user/info' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "usernames": ["elonmusk", "OpenAI"]
  }'

सफल प्रतिक्रिया (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 2,
    "users": [
      {
        "user_id": "44196397",
        "username": "elonmusk",
        "display_name": "Elon Musk",
        "description": "...",
        "followers_count": 100000000,
        "following_count": 500,
        "tweet_count": 30000,
        "verified": true,
        "blue_verified": true,
        "profile_image_url": "https://pbs.twimg.com/...",
        "created_at": "2009-06-02T00:00:00Z",
        "location": "Mars"
      }
    ]
  }
}

उपयोगकर्ता ऑब्जेक्ट फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`user_id`	string	X उपयोगकर्ता ID
`username`	string	X हैंडल (@ के बिना)
`display_name`	string	डिस्प्ले नाम
`description`	string	उपयोगकर्ता बायो
`followers_count`	integer	फ़ॉलोअर की संख्या
`following_count`	integer	फ़ॉलोइंग की संख्या
`tweet_count`	integer	कुल ट्वीट
`verified`	boolean	खाता सत्यापित है या नहीं
`blue_verified`	boolean	खाते में Blue सत्यापन है या नहीं
`verified_type`	string	सत्यापन प्रकार
`profile_image_url`	string	प्रोफ़ाइल इमेज URL
`cover_image_url`	string	कवर इमेज URL
`created_at`	string	खाता बनने का समय
`location`	string	उपयोगकर्ता स्थान
`url`	string	उपयोगकर्ता वेबसाइट URL
`protected`	boolean	खाता सुरक्षित है या नहीं
`favorites_count`	integer	लाइक की संख्या
`media_count`	integer	मीडिया पोस्ट की संख्या
`can_dm`	boolean	DM खुला है या नहीं
`is_automated`	boolean	खाता स्वचालित है या नहीं
`pinned_tweet_ids`	array of strings	पिन किए गए ट्वीट ID

2. उपयोगकर्ता खोजें

कीवर्ड से X उपयोगकर्ता खोजें।

Endpoint

POST https://openapi.felo.ai/v2/x/user/search

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
`query`	string	हां	खोज कीवर्ड
`cursor`	string	नहीं	पिछली प्रतिक्रिया का pagination cursor

उदाहरण

curl -X POST 'https://openapi.felo.ai/v2/x/user/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "artificial intelligence"
  }'

सफल प्रतिक्रिया (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 50,
    "has_next": true,
    "next_cursor": "cursor_abc123",
    "users": [
      {
        "user_id": "...",
        "username": "...",
        "display_name": "..."
      }
    ]
  }
}

प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`total`	integer	परिणामों की कुल संख्या
`has_next`	boolean	और परिणाम उपलब्ध हैं या नहीं
`next_cursor`	string	अगले पेज के लिए cursor
`users`	array	उपयोगकर्ता ऑब्जेक्ट की सूची (धारा 1 देखें)

3. उपयोगकर्ता के ट्वीट प्राप्त करें

किसी विशिष्ट X उपयोगकर्ता के ट्वीट प्राप्त करें।

Endpoint

POST https://openapi.felo.ai/v2/x/user/tweets

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
`x_user_id`	string	नहीं	X उपयोगकर्ता ID (`x_user_id` या `username` में से एक दें)
`username`	string	नहीं	X उपयोगकर्ता नाम (`x_user_id` या `username` में से एक दें)
`limit`	integer	नहीं	लौटाने के लिए ट्वीट की संख्या
`cursor`	string	नहीं	Pagination cursor
`include_replies`	boolean	नहीं	रिप्लाई शामिल करने हैं या नहीं

उदाहरण

curl -X POST 'https://openapi.felo.ai/v2/x/user/tweets' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "elonmusk",
    "limit": 20
  }'

सफल प्रतिक्रिया (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 20,
    "has_next": true,
    "next_cursor": "cursor_def456",
    "tweets": [
      {
        "id": "1234567890",
        "content": "Tweet content here...",
        "author": { "user_id": "...", "username": "elonmusk" },
        "created_at": "2026-03-09T12:00:00Z",
        "metrics": {
          "retweet_count": 1000,
          "favorite_count": 5000,
          "reply_count": 200,
          "quote_count": 100,
          "view_count": 500000,
          "bookmark_count": 50
        },
        "hashtags": ["AI"],
        "mentions": ["OpenAI"],
        "url": "https://x.com/elonmusk/status/1234567890",
        "lang": "en"
      }
    ]
  }
}

ट्वीट ऑब्जेक्ट फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`id`	string	ट्वीट ID
`content`	string	ट्वीट टेक्स्ट सामग्री
`author`	object	लेखक उपयोगकर्ता ऑब्जेक्ट (धारा 1 देखें)
`created_at`	string	ट्वीट बनने का समय
`metrics`	object	एंगेजमेंट मेट्रिक्स (नीचे देखें)
`replies`	array	रिप्लाई ट्वीट (यदि उपलब्ध)
`conversation_id`	string	बातचीत थ्रेड ID
`media_urls`	array	संलग्न मीडिया
`hashtags`	array of strings	ट्वीट में हैशटैग
`mentions`	array of strings	उल्लेखित उपयोगकर्ता नाम
`urls`	array of strings	ट्वीट में URL
`url`	string	ट्वीट का परमालिंक
`source`	string	ट्वीट स्रोत (जैसे "Twitter Web App")
`lang`	string	ट्वीट भाषा कोड
`is_reply`	boolean	यह रिप्लाई है या नहीं
`in_reply_to_id`	string	जिस ट्वीट का उत्तर दिया जा रहा है उसका ID
`in_reply_to_user_id`	string	जिस ट्वीट का उत्तर दिया जा रहा है उसका उपयोगकर्ता ID
`in_reply_to_username`	string	जिस ट्वीट का उत्तर दिया जा रहा है उसका उपयोगकर्ता नाम
`quoted_tweet`	object	उद्धृत ट्वीट ऑब्जेक्ट (पुनरावर्ती)
`retweeted_tweet`	object	रीट्वीट किया गया ट्वीट ऑब्जेक्ट (पुनरावर्ती)
`is_limited_reply`	boolean	रिप्लाई सीमित हैं या नहीं

Metrics ऑब्जेक्ट फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`retweet_count`	integer	रीट्वीट की संख्या
`favorite_count`	integer	लाइक की संख्या
`reply_count`	integer	रिप्लाई की संख्या
`quote_count`	integer	कोट की संख्या
`view_count`	integer	व्यू की संख्या
`bookmark_count`	integer	बुकमार्क की संख्या

4. ट्वीट खोजें

उन्नत क्वेरी समर्थन के साथ कीवर्ड से X ट्वीट खोजें।

Endpoint

POST https://openapi.felo.ai/v2/x/tweet/search

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
`query`	string	हां	खोज क्वेरी (उन्नत खोज सिंटैक्स का समर्थन करती है)
`query_type`	string	नहीं	क्वेरी प्रकार फ़िल्टर
`since_time`	integer	नहीं	प्रारंभ समय फ़िल्टर (Unix टाइमस्टैम्प सेकंड में)
`until_time`	integer	नहीं	अंत समय फ़िल्टर (Unix टाइमस्टैम्प सेकंड में)
`limit`	integer	नहीं	लौटाने के लिए ट्वीट की संख्या
`cursor`	string	नहीं	Pagination cursor

उदाहरण

curl -X POST 'https://openapi.felo.ai/v2/x/tweet/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "artificial intelligence",
    "limit": 20
  }'

सफल प्रतिक्रिया (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 20,
    "has_next": true,
    "next_cursor": "cursor_ghi789",
    "tweets": [
      {
        "id": "...",
        "content": "...",
        "author": { "user_id": "...", "username": "..." },
        "created_at": "2026-03-09T12:00:00Z",
        "metrics": { "retweet_count": 100, "favorite_count": 500 }
      }
    ]
  }
}

प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`total`	integer	परिणामों की कुल संख्या
`has_next`	boolean	और परिणाम उपलब्ध हैं या नहीं
`next_cursor`	string	अगले पेज के लिए cursor
`tweets`	array	ट्वीट ऑब्जेक्ट की सूची (धारा 3 देखें)

5. ट्वीट रिप्लाई प्राप्त करें

विशिष्ट ट्वीट के लिए रिप्लाई प्राप्त करें।

Endpoint

POST https://openapi.felo.ai/v2/x/tweet/replies

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
`tweet_ids`	array of strings	हां	रिप्लाई प्राप्त करने के लिए ट्वीट ID
`cursor`	string	नहीं	Pagination cursor
`since_time`	integer	नहीं	प्रारंभ समय फ़िल्टर (Unix टाइमस्टैम्प)
`until_time`	integer	नहीं	अंत समय फ़िल्टर (Unix टाइमस्टैम्प)

उदाहरण

curl -X POST 'https://openapi.felo.ai/v2/x/tweet/replies' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "tweet_ids": ["1234567890"]
  }'

सफल प्रतिक्रिया (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "results": [
      {
        "tweet_id": "1234567890",
        "total": 10,
        "has_next": true,
        "next_cursor": "cursor_jkl012",
        "replies": [
          {
            "id": "...",
            "content": "Great tweet!",
            "author": { "user_id": "...", "username": "..." },
            "created_at": "2026-03-09T12:30:00Z"
          }
        ]
      }
    ]
  }
}

प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`results`	array	रिप्लाई परिणाम ऑब्जेक्ट की सूची
`results[].tweet_id`	string	मूल ट्वीट ID
`results[].total`	integer	रिप्लाई की कुल संख्या
`results[].has_next`	boolean	और रिप्लाई उपलब्ध हैं या नहीं
`results[].next_cursor`	string	अगले पेज के लिए cursor
`results[].replies`	array	रिप्लाई ट्वीट ऑब्जेक्ट की सूची (धारा 3 देखें)

त्रुटि कोड

कोड	HTTP स्टेटस	विवरण
`UNAUTHORIZED`	401	API Key अमान्य या रद्द है
`X_SEARCH_FAILED`	400/500	X खोज अनुरोध विफल (पैरामीटर या downstream त्रुटि जांचें)
`RATE_LIMIT_EXCEEDED`	429	बहुत ज़्यादा अनुरोध, कृपया थोड़ी देर बाद दोबारा प्रयास करें
`insufficient_credits`	402	अनुरोध पूरा करने के लिए अपर्याप्त क्रेडिट

क्रेडिट और दर सीमा

क्रेडिट लागत

हर API कॉल लौटाए गए परिणामों की संख्या के आधार पर क्रेडिट काटता है:

Endpoint	क्रेडिट लागत
`POST /x/user/info`	प्रति लौटाया गया उपयोगकर्ता 1 क्रेडिट
`POST /x/user/search`	प्रति लौटाया गया उपयोगकर्ता 1 क्रेडिट
`POST /x/user/tweets`	प्रति लौटाया गया ट्वीट 1 क्रेडिट
`POST /x/tweet/search`	प्रति लौटाया गया ट्वीट 1 क्रेडिट
`POST /x/tweet/replies`	प्रति लौटाया गया रिप्लाई 1 क्रेडिट

क्रेडिट अनुरोध पूरा होने के बाद, परिणामों की वास्तविक संख्या के आधार पर काटे जाते हैं। अगर किसी अनुरोध से 0 परिणाम आते हैं, तो कोई क्रेडिट नहीं कटता।

न्यूनतम बैलेंस आवश्यकता: कोई भी X API अनुरोध करने के लिए आपके खाते में कम से कम 10 क्रेडिट होने चाहिए। 10 से कम क्रेडिट के साथ किए गए अनुरोध HTTP 402 के साथ अस्वीकार किए जाएंगे।

दर सीमा

दर सीमाएं वर्तमान API सेवा और खाता नीतियों के अनुसार लागू होती हैं। दर सीमित होने पर API HTTP 429 लौटाती है। Retry-After हेडर सुझाया गया प्रतीक्षा समय सेकंड में बताता है। दर सीमाएं संभालने के लिए नवीनतम सेवा दस्तावेज़ और वास्तविक API प्रतिक्रियाओं का उपयोग करें; प्लेटफ़ॉर्म का उपयोग करने के लिए किसी सदस्यता की ज़रूरत नहीं है।