# Carian Pengguna X Felo

POST /api/v1/data/x/user/search

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](https://openapi.felo.ai/ms/docs/data-api/guides/felo-overview.md). Panggilan menggunakan **baki platform**, bukan kredit Felo Pro. Contoh respons adalah ilustratif; kandungan langsung dan medan pilihan berbeza.





## 2. Cari pengguna

`POST /api/v1/data/x/user/search`

| Medan | Jenis | Diperlukan | Makna |
|---|---|---|---|
| `query` | string | Ya | 1–1,000 aksara |
| `cursor` | string | Tidak | Cursor paginasi, sehingga 4,000 aksara |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"AI research"}'
```

Respons mengandungi `users`, `total`, `has_next` dan `next_cursor`. Tiada parameter `limit` pada operasi ini.

```json
{"users":[],"total":0,"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.

1. Hantar permintaan pertama tanpa `cursor`.
2. Baca `has_next` dan `next_cursor` daripada respons. Untuk balasan, baca pada setiap entri hasil.
3. Jika ada halaman lain dan cursor tidak kosong, hantar semula tanpa perubahan dengan pertanyaan yang sama. Untuk kelompok balasan, teruskan setiap catatan secara berasingan.
4. 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](https://openapi.felo.ai/api/v1/data/prices) dan penggunaan dalam konsol. Medan objek lengkap ada dalam [skema OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).