# Felo X ব্যবহারকারী অনুসন্ধান

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

আপনার প্রয়োজনীয় ডেটার জন্য উপযুক্ত operation বেছে নিন। পাঁচটি endpoint-ই POST ব্যবহার করে এবং কোনো common `data` wrapper ছাড়া root-এ JSON ফেরত দেয়।

সব example-ই [overview](https://openapi.felo.ai/bn/docs/data-api/guides/felo-overview.md) থেকে `FELO_API_KEY` ব্যবহার করে। Call-গুলো **platform balance** ব্যবহার করে, Felo Pro credits নয়। Response example-গুলো illustrative; live content এবং optional field ভিন্ন হতে পারে।





## 2. ব্যবহারকারী অনুসন্ধান করুন

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

| ক্ষেত্র | ধরন | প্রয়োজনীয় | অর্থ |
| --- | --- | --- | --- |
| `query` | string | হ্যাঁ | 1–1,000 অক্ষর |
| `cursor` | string | না | পেজিনেশন কার্সর, সর্বোচ্চ 4,000 অক্ষর |

```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"}'
```

Response-এ `users`, `total`, `has_next` এবং `next_cursor` থাকে। এই operation-এ `limit` parameter নেই।

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



## পেজিনেশন এবং খরচ নিয়ন্ত্রণ

`total` বর্তমান response-এর সংশ্লিষ্ট array গণনা করে: post query-র জন্য top-level post, অথবা reply query-র জন্য প্রতিটি result entry-র মধ্যে reply। এটি global match count, কোনো post-এর সম্পূর্ণ reply count, বা চূড়ান্ত billable count নয়।

1. `cursor` ছাড়া প্রথম request পাঠান।
2. Response থেকে `has_next` এবং `next_cursor` পড়ুন। Reply-এর ক্ষেত্রে, প্রতিটি result entry-তে এগুলো পড়ুন।
3. যদি আরেকটি page থাকে এবং cursor খালি না হয়, একই query-সহ অপরিবর্তিত অবস্থায় তা পাঠান। Reply batch-এর জন্য, প্রতিটি post আলাদাভাবে চালিয়ে যান।
4. Next page না থাকলে, cursor পুনরাবৃত্ত হলে, বা আপনার নিজস্ব page বা spending limit-এ পৌঁছালে থামুন।

Pagination metadata শেষ upstream response প্রতিফলিত করে; ফেরত আসা collection result cap-এ truncate হতে পারে। এমনকি `has_next=false`-ও সব X history বা reply আহরণ হয়েছে—এমন নিশ্চয়তা নয়। সীমাবদ্ধ result set-কে all available data বলে label না করে প্রকৃত ফেরত আসা count প্রদর্শন করুন।

প্রতিটি successful page-এ চার্জ হতে পারে। এই পাঁচটি operation flat request fee নয়, ফেরত আসা result অনুযায়ী বিল হয়। Nested reply এবং অন্যান্য ফেরত আসা record bill করা count-এ প্রভাব ফেলতে পারে; কেবল top-level array length থেকে খরচ অনুমান করবেন না। [current prices](https://openapi.felo.ai/api/v1/data/prices) এবং console-এ usage পরীক্ষা করুন। সম্পূর্ণ object field [OpenAPI schema](https://openapi.felo.ai/api/v1/data/openapi.json)-এ রয়েছে।