חיפוש פוסטים של Felo ב-X

בחרו את הפעולה עבור הנתונים שאתם צריכים. כל חמש נקודות הקצה משתמשות ב-POST ומחזירות JSON בשורש, ללא מעטפת data משותפת.

כל הדוגמאות משתמשות ב-FELO_API_KEY מתוך הסקירה הכללית. הקריאות משתמשות ב-יתרת הפלטפורמה, ולא ב-Felo Pro credits. דוגמאות התגובה הן להמחשה; תוכן חי ושדות אופציונליים משתנים.

4. חיפוש פוסטים

POST /api/v1/data/x/tweet/search

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/tweet/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"retrieval augmented generation","query_type":"Latest","limit":20}'

התגובה מכילה tweets, total, has_next ו-next_cursor. אובייקטי פוסט כוללים id, content, author, created_at ו-metrics; תגובות ופוסטים מצוטטים/מועתקים עשויים להיות מקוננים. התייחסו למזהים כמחרוזות.

מגבלות כמות תוצאות

limit הוא יעד, לא הבטחה. המימוש הנוכחי משתמש ביעד של 20 לפחות: יעד של 20 קורא דף upstream אחד; יעדים גדולים יותר שולפים אוטומטית עד 50 דפים. הזמן שחלף נבדק לפני כל דף, ולא נשלפים דפים נוספים לאחר שהוא עובר 60 שניות. בקשת upstream שבאוויר עדיין יכולה לקחת זמן, לכן זה אינו timeout HTTP כולל.

הקולקציה גם נעצרת כאשר היעד מושג, ל-upstream אין דף הבא, דף ריק, או שה-cursor חסר. החזרת פחות פוסטים מ-limit אינה אומרת שהבקשה נכשלה או שכל פוסט תואם אוחזר. בדקו has_next ו-next_cursor לפני המשך.

{
  "tweets": [{
    "id":"example-post-id",
    "content":"Example post content",
    "author":{"user_id":"example-user-id","username":"example","display_name":"Example"},
    "created_at":"2026-11-01T00:00:00Z",
    "metrics":{},
    "replies":[]
  }],
  "total":1,
  "has_next":false,
  "next_cursor":null
}

דפדוף ובקרת עלויות

total סופר את המערך המתאים בתגובה הנוכחית: פוסטים ברמה העליונה עבור שאילתות פוסטים, או תגובות בתוך כל רשומת תוצאה עבור שאילתות תגובות. זה אינו סך התאמות גלובלי, מספר התגובות המלא של פוסט, או מספר החיוב הסופי.

1. שלחו את הבקשה הראשונה ללא cursor.
2. קראו has_next ו-next_cursor מהתגובה. עבור תגובות, קראו אותם בכל רשומת תוצאה.
3. אם קיימת עמודה נוספת וה-cursor אינו ריק, שלחו אותו ללא שינוי עם אותה שאילתה. עבור אצוות תגובות, המשיכו כל פוסט בנפרד.
4. עצרו כאשר אין עמוד הבא, כאשר cursor חוזר על עצמו, או כאשר הגעתם למגבלת העמודים או ההוצאה שלכם.

מטא-נתוני הדפדוף משקפים את תגובת ה-upstream האחרונה; האוסף המוחזר יכול להיות מקוצר במגבלת תוצאות. אפילו has_next=false אינו הבטחה שכל היסטוריית X או כל התגובות אוחזרו. הציגו את הכמות שהוחזרה בפועל במקום לתייג קבוצת תוצאות מוגבלת ככול הנתונים הזמינים.

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