Carian Catatan X Felo
Penyedia: Felo · Dibayar dengan baki platform
Pilih operasi untuk data yang anda perlukan. Semua lima titik akhir menggunakan POST dan memulangkan JSON pada akar, tanpa pembungkus data yang umum.
Semua contoh menggunakan FELO_API_KEY daripada gambaran keseluruhan. Panggilan menggunakan baki platform, bukan kredit Felo Pro. Contoh respons adalah ilustratif; kandungan langsung dan medan pilihan berbeza.
4. Cari catatan
POST /api/v1/data/x/tweet/search
| Medan | Jenis | Diperlukan | Makna |
|---|---|---|---|
query | string | Ya | Teks carian, 1–1,000 aksara |
query_type | string | Tidak | Latest (lalai) atau Top |
limit | integer | Tidak | 1–1,000; pelaksanaan semasa menggunakan sekurang-kurangnya 20, dengan lalai 20 |
cursor | string | Tidak | Cursor paginasi, sehingga 4,000 aksara |
since_time | integer or string | Tidak | Masa mula; gunakan saat Unix untuk nilai angka yang tidak samar |
until_time | integer or string | Tidak | Masa tamat; gunakan saat Unix, bukan milisaat |
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}'Respons mengandungi tweets, total, has_next dan next_cursor. Objek catatan merangkumi id, content, author, created_at dan metrics; balasan dan catatan petikan/ulang siar mungkin bersarang. Perlakukan ID sebagai string.
Had kiraan hasil
limit ialah sasaran, bukan jaminan. Pelaksanaan semasa menggunakan sasaran sekurang-kurangnya 20: sasaran 20 membaca satu halaman huluan; sasaran yang lebih besar secara automatik mengambil sehingga 50 halaman. Masa berlalu disemak sebelum setiap halaman, dan tiada halaman lanjut diambil sebaik sahaja ia melebihi 60 saat. Permintaan huluan yang sedang berjalan masih boleh mengambil masa, jadi ini bukan tamat masa HTTP keseluruhan.
Pengumpulan juga berhenti apabila sasaran dicapai, huluan tiada halaman seterusnya, halaman kosong, atau cursor hilang. Memulangkan lebih sedikit catatan daripada limit tidak bermaksud permintaan gagal atau bahawa setiap catatan padanan telah diambil. Semak has_next dan next_cursor sebelum meneruskan.
{
"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
}Paginasi dan kawalan kos
total mengira tatasusunan yang sepadan dalam respons semasa: catatan aras atas untuk pertanyaan catatan, atau balasan dalam setiap entri hasil untuk pertanyaan balasan. Ia bukan kiraan padanan global, bukan kiraan balasan lengkap catatan, dan bukan kiraan boleh dibilkan akhir.
- Hantar permintaan pertama tanpa
cursor. - Baca
has_nextdannext_cursordaripada respons. Untuk balasan, baca pada setiap entri hasil. - Jika ada halaman lain dan cursor tidak kosong, hantar semula tanpa perubahan dengan pertanyaan yang sama. Untuk kelompok balasan, teruskan setiap catatan secara berasingan.
- Berhenti apabila tiada halaman seterusnya, apabila cursor berulang, atau apabila had halaman atau perbelanjaan anda dicapai.
Metadata paginasi mencerminkan respons huluan terakhir; koleksi yang dipulangkan boleh dipotong pada had hasil. Malah has_next=false bukan jaminan bahawa semua sejarah X atau balasan telah diambil. Paparkan kiraan sebenar yang dipulangkan dan bukannya melabelkan set hasil terhad sebagai semua data yang tersedia.
Setiap halaman berjaya boleh menanggung caj. Lima operasi ini dibilkan mengikut hasil yang dipulangkan, bukan yuran permintaan tetap. Balasan bersarang dan rekod lain yang dipulangkan boleh mempengaruhi kiraan yang dibilkan; jangan anggarkan kos semata-mata berdasarkan panjang tatasusunan aras atas. Semak harga semasa dan penggunaan dalam konsol. Medan objek lengkap ada dalam skema OpenAPI.