# Felo X ব্যবহারকারী পোস্ট

POST /api/v1/data/x/user/tweets

আপনার প্রয়োজনীয় ডেটার জন্য উপযুক্ত 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 ভিন্ন হতে পারে।





## 3. একটি ব্যবহারকারীর টাইমলাইন পান

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

| ক্ষেত্র | ধরন | প্রয়োজনীয় | অর্থ |
| --- | --- | --- | --- |
| `username` | string | একটি পরিচায়ক প্রয়োজন | ব্যবহারকারীর হ্যান্ডেল, সর্বোচ্চ 100 অক্ষর |
| `x_user_id` | string | একটি পরিচায়ক প্রয়োজন | ব্যবহারকারী পরিচায়ক, সর্বোচ্চ 100 অক্ষর; `username`-এর উপর অগ্রাধিকার পায় |
| `limit` | integer | না | 1–1,000; বর্তমান বাস্তবায়নে অন্তত 20 ব্যবহার হয়, ডিফল্ট 20 |
| `cursor` | string | না | পেজিনেশন কার্সর, সর্বোচ্চ 4,000 অক্ষর |
| `include_replies` | boolean | না | নেস্টেড উত্তরসমূহ অন্তর্ভুক্ত করুন; ডিফল্ট `false` |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/tweets" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"OpenAI","limit":20,"include_replies":false}'
```

Response-এ `tweets`, `total`, `has_next` এবং `next_cursor` থাকে। `limit`-কে 20-এর নিচে সেট করলে কম item ফেরত আসবে বা bill কম হবে—এমন নিশ্চয়তা নেই। Reply অন্তর্ভুক্ত করলে ফেরত আসা data এবং billable result বাড়তে পারে।

### ফলাফল এবং নেস্টেড উত্তরসীমা

`limit` হলো এই request-এর top-level post-এর লক্ষ্য সংখ্যা, guaranteed result count নয়। বর্তমান implementation কমপক্ষে 20-এর target ব্যবহার করে: 20-এর target একটি upstream page পড়ে; বড় target-এ স্বয়ংক্রিয়ভাবে সর্বোচ্চ 50 page fetch করে। প্রতিটি page-এর আগে elapsed time পরীক্ষা করা হয় এবং 60 second অতিক্রম করলে আরও page fetch বন্ধ হয়। এই পরীক্ষা পুরো HTTP request 60 second-এর মধ্যে শেষ হবে—এমন নিশ্চয়তা নয়।

Target পূরণ হলে, upstream-এ next page না থাকলে, একটি page ফাঁকা হলে, বা cursor অনুপস্থিত থাকলে collection-ও থেমে যায়। তাই একটি successful response-এ `limit`-এর চেয়ে কম post থাকতে পারে। উপলভ্য হলে চালিয়ে যেতে `has_next` এবং `next_cursor` ব্যবহার করুন।

`include_replies=true` হলে, প্রতিটি ফেরত আসা post-এর জন্য সর্বোচ্চ 5টি অতিরিক্ত page এবং সর্বাধিক 100টি nested reply যোগ হয়। Next page না থাকলে, page ফাঁকা হলে, বা cursor অগ্রসর হতে না পারলে collection আরও আগে বন্ধ হতে পারে। এই nested reply-গুলো top-level `limit` এবং `total`-এর বাইরে, কিন্তু billable result বাড়াতে পারে।

Nested `replies` সম্পূর্ণ reply archive নয় এবং এই অতিরিক্ত collection-এর জন্য আলাদা continuation cursor প্রকাশ করে না। স্বাধীনভাবে reply paginate করতে Read replies operation এবং এর ফেরত দেওয়া cursor ব্যবহার করুন। Reply-র জন্য top-level post cursor পুনর্ব্যবহার করবেন না।



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

`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)-এ রয়েছে।