Felo APIs

X Search API

חפשו משתמשי X, ציוצים, צירי זמן ותגובות עם מטא-נתונים של עימוד.

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), כולל פרופילי משתמשים, חיפוש ציוצים, ציוצים של משתמשים ותגובות לציוצים.

אימות

כל הבקשות דורשות מפתח API בכותרת Authorization:

Authorization: Bearer YOUR_API_KEY

שימוש עם סוכני AI

התקינו את החבילה המלאה felo-ai כדי להעניק לסוכן X Search וכל Felo Skill זמין אחר. המתקין מגלה באופן דינמי כל תיקיית חבילה שמכילה SKILL.md, במקום להחזיק רשימת Skills קבועה. התקינו את כל ה-Skills שהתגלו ב-Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills או Hermes Agent ~/.hermes/skills. ראו את מדריך ההגדרה הידנית לסוכני AI להוראות התקנה, מפתח API ואימות ייחודיות לפלטפורמה.

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
`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	כתובת האתר של המשתמש
`protected`	boolean	האם החשבון מוגן
`favorites_count`	integer	מספר הלייקים
`media_count`	integer	מספר פרסומי המדיה
`can_dm`	boolean	האם הודעות ישירות פתוחות
`is_automated`	boolean	האם החשבון אוטומטי
`pinned_tweet_ids`	array of strings	מזהי ציוצים מוצמדים

2. חיפוש משתמשים

חיפוש משתמשי X לפי מילת מפתח.

Endpoint

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

גוף הבקשה

פרמטר	סוג	חובה	תיאור
`query`	string	כן	מילת המפתח לחיפוש
`cursor`	string	לא	סמן חלוקה לעמודים מהתגובה הקודמת

דוגמה

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	סמן לעמוד הבא
`users`	array	רשימת אובייקטי משתמש (ראו סעיף 1)

3. קבלת ציוצים של משתמש

שליפת ציוצים ממשתמש X ספציפי.

Endpoint

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

גוף הבקשה

פרמטר	סוג	חובה	תיאור
`x_user_id`	string	לא	מזהה המשתמש ב-X (ספקו `x_user_id` או `username`)
`username`	string	לא	שם המשתמש ב-X (ספקו `x_user_id` או `username`)
`limit`	integer	לא	מספר הציוצים להחזרה
`cursor`	string	לא	סמן חלוקה לעמודים
`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	מזהה הציוץ
`content`	string	תוכן הטקסט של הציוץ
`author`	object	אובייקט המשתמש של המחבר (ראו סעיף 1)
`created_at`	string	זמן יצירת הציוץ
`metrics`	object	מדדי מעורבות (ראו בהמשך)
`replies`	array	ציוצי תגובה (אם זמינים)
`conversation_id`	string	מזהה שרשור השיחה
`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	מזהה הציוץ שאליו מגיבים
`in_reply_to_user_id`	string	מזהה המשתמש של הציוץ שאליו מגיבים
`in_reply_to_username`	string	שם המשתמש של הציוץ שאליו מגיבים
`quoted_tweet`	object	אובייקט הציוץ המצוטט (רקורסיבי)
`retweeted_tweet`	object	אובייקט הציוץ ששותף מחדש (רקורסיבי)
`is_limited_reply`	boolean	האם התגובות מוגבלות

שדות אובייקט המדדים

שדה	סוג	תיאור
`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	לא	סמן חלוקה לעמודים

דוגמה

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	סמן לעמוד הבא
`tweets`	array	רשימת אובייקטי ציוץ (ראו סעיף 3)

5. קבלת תגובות לציוץ

שליפת תגובות לציוצים ספציפיים.

Endpoint

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

גוף הבקשה

פרמטר	סוג	חובה	תיאור
`tweet_ids`	array of strings	כן	מזהי ציוצים לקבלת תגובות עבורם
`cursor`	string	לא	סמן חלוקה לעמודים
`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	מזהה הציוץ המקורי
`results[].total`	integer	מספר התגובות הכולל
`results[].has_next`	boolean	האם זמינות תגובות נוספות
`results[].next_cursor`	string	סמן לעמוד הבא
`results[].replies`	array	רשימת אובייקטי ציוצי תגובה (ראו סעיף 3)

קודי שגיאה

קוד	סטטוס HTTP	תיאור
`UNAUTHORIZED`	401	מפתח ה-API לא חוקי או בוטל
`X_SEARCH_FAILED`	400/500	בקשת החיפוש ב-X נכשלה (בדקו את הפרמטרים או שגיאה במורד הזרם)
`RATE_LIMIT_EXCEEDED`	429	יותר מדי בקשות, נסו שוב לאחר השהיה קצרה
`insufficient_credits`	402	אין מספיק קרדיטים להשלמת הבקשה

קרדיטים ומגבלות קצב

עלויות קרדיטים

כל קריאת API מנכה קרדיטים בהתאם למספר התוצאות שהוחזרו:

Endpoint	עלות בקרדיטים
`POST /x/user/info`	קרדיט אחד לכל משתמש שמוחזר
`POST /x/user/search`	קרדיט אחד לכל משתמש שמוחזר
`POST /x/user/tweets`	קרדיט אחד לכל ציוץ שמוחזר
`POST /x/tweet/search`	קרדיט אחד לכל ציוץ שמוחזר
`POST /x/tweet/replies`	קרדיט אחד לכל תגובה שמוחזרת

הקרדיטים מנוכים לאחר השלמת הבקשה, לפי מספר התוצאות בפועל. אם בקשה מחזירה 0 תוצאות, לא מנוכים קרדיטים.

דרישת יתרה מינימלית: בחשבון שלכם חייבים להיות לפחות 10 קרדיטים כדי לבצע כל בקשת X API. בקשות שנעשות עם פחות מ-10 קרדיטים יידחו עם HTTP 402.

מגבלת קצב

מגבלות הקצב נאכפות בהתאם למדיניות שירות ה-API ולמדיניות החשבון הנוכחיות. כשמגבלת הקצב מופעלת, ה-API מחזיר HTTP 429. הכותרת Retry-After מציינת את זמן ההמתנה המומלץ בשניות. השתמשו בתיעוד השירות העדכני ובתגובות ה-API בפועל כדי לטפל במגבלות קצב; אין צורך במינוי כדי להשתמש בפלטפורמה.