# Pencarian Pengguna Felo X

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

Pilih operasi untuk data yang Anda butuhkan. Kelima endpoint menggunakan POST dan mengembalikan JSON di root, tanpa pembungkus `data` bersama.

Semua contoh menggunakan `FELO_API_KEY` dari [gambaran umum](https://openapi.felo.ai/id/docs/data-api/guides/felo-overview.md). Panggilan menggunakan **saldo platform**, bukan kredit Felo Pro. Contoh respons bersifat ilustratif; konten langsung dan bidang opsional bervariasi.





## 2. Cari pengguna

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

| Bidang | Tipe | Wajib | Arti |
|---|---|---|---|
| `query` | string | Ya | 1–1.000 karakter |
| `cursor` | string | Tidak | Cursor paginasi, hingga 4.000 karakter |

```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 berisi `users`, `total`, `has_next`, dan `next_cursor`. Tidak ada parameter `limit` pada operasi ini.

```json
{"users":[],"total":0,"has_next":false,"next_cursor":null}
```



## Paginasi dan pengendalian biaya

`total` menghitung array yang bersesuaian dalam respons saat ini: postingan tingkat atas untuk kueri post, atau balasan di dalam setiap entri hasil untuk kueri balasan. Ini bukan jumlah kecocokan global, bukan jumlah balasan lengkap sebuah post, dan bukan jumlah billable final.

1. Kirim permintaan pertama tanpa `cursor`.
2. Baca `has_next` dan `next_cursor` dari respons. Untuk balasan, baca pada setiap entri hasil.
3. Jika ada halaman lain dan cursor tidak kosong, kirim ulang tanpa perubahan dengan kueri yang sama. Untuk batch balasan, lanjutkan setiap post secara terpisah.
4. Hentikan ketika tidak ada halaman berikutnya, ketika cursor berulang, atau ketika batas halaman atau pengeluaran Anda sendiri tercapai.

Metadata paginasi mencerminkan respons upstream terakhir; koleksi yang dikembalikan dapat dipotong pada batas hasil. Bahkan `has_next=false` bukan jaminan bahwa semua histori X atau balasan telah diambil. Tampilkan jumlah aktual yang dikembalikan, bukan memberi label kumpulan hasil terbatas sebagai semua data yang tersedia.

Setiap halaman sukses dapat menimbulkan biaya. Kelima operasi ini ditagihkan berdasarkan hasil yang dikembalikan, bukan biaya permintaan tetap. Balasan bertingkat dan rekaman lain yang dikembalikan dapat memengaruhi jumlah yang ditagihkan; jangan perkirakan biaya hanya dari panjang array tingkat atas. Periksa [harga terkini](https://openapi.felo.ai/api/v1/data/prices) dan penggunaan di konsol. Bidang objek lengkap ada di [skema OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).