> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# অ্যানালিটিক্স

> CLI থেকে প্ল্যাটফর্ম-স্তরের ও প্রতি-পোস্ট অ্যানালিটিক্স আনুন

অ্যানালিটিক্স কমান্ড একটি সংযুক্ত প্ল্যাটফর্মের অ্যাকাউন্ট-স্তরের মেট্রিক এবং একটি পোস্টের পারফরম্যান্স মেট্রিক ফেরত দেয়। আউটপুট ডিফল্টভাবে JSON — মানুষের পড়ার উপযোগী ভিউয়ের জন্য `--table` দিন, অথবা স্ক্রিপ্টিংয়ের জন্য JSON `jq`-তে পাইপ করুন।

## analytics:platform

একটি প্ল্যাটফর্ম সেকশন বা সোশ্যাল অ্যাকাউন্টের অ্যানালিটিক্স আনুন।

```bash theme={null}
so-me analytics:platform <account-id-or-platform> [section] [options]
```

**account-id-or-platform** `string` *required*

অ্যাকাউন্ট UUID, অথবা প্ল্যাটফর্মের নাম (`facebook`, `instagram`, `linkedin`, `linkedin_page`, `youtube`, `x`, `twitter`, `whatsapp`)। প্ল্যাটফর্মের নাম দিলে CLI সেটিকে আপনার ওয়ার্কস্পেসে ওই প্ল্যাটফর্মের প্রথম সংযুক্ত অ্যাকাউন্টে সমাধান করে।

**section** `string`

যে অ্যানালিটিক্স সেকশন আনতে হবে (যেমন `page`, `posts`, `videos`, `account`, `media`, `stories`, `channel`, `content`)। সেকশন প্ল্যাটফর্ম অনুযায়ী ভিন্ন — নিচের টেবিল দেখুন। প্ল্যাটফর্মের নাম দিলে উপলব্ধ সেকশন দেখতে, অথবা শনাক্তকারী অ্যাকাউন্ট UUID হলে সম্মিলিত প্ল্যাটফর্ম সারসংক্ষেপ আনতে এটি বাদ দিন।

| অপশন | বিবরণ | ডিফল্ট |
| - | - | - |
| `-d, --days <number>` | দিনে পেছনে তাকানোর সময়কাল: `7`, `30` বা `90` | `7` |

### উপলব্ধ সেকশন

| প্ল্যাটফর্ম | শনাক্তকারী | সেকশন |
| - | - | - |
| Facebook | `facebook` | `page`, `posts`, `videos` |
| Instagram | `instagram` | `account`, `media`, `stories` |
| LinkedIn | `linkedin` | `page`, `posts` |
| LinkedIn Page | `linkedin_page` | `page`, `posts` |
| YouTube | `youtube` | `channel`, `videos` |
| Twitter / X | `x`, `twitter` | `account`, `content` |
| WhatsApp | `whatsapp` | `account` |

> [!NOTE]
>
> প্ল্যাটফর্মের অ্যালিয়াস অনুরোধ পাঠানোর আগে স্বয়ংক্রিয়ভাবে স্বাভাবিকীকৃত হয়: `twitter`-কে `x` এবং `linkedin_page`-কে `linkedin` ধরা হয়।

### সমাধান যেভাবে কাজ করে

**1. প্ল্যাটফর্মের নাম + সেকশন নেই**

CLI ওই প্ল্যাটফর্মের উপলব্ধ সেকশন প্রিন্ট করে এবং কোনো অনুরোধ না পাঠিয়েই বেরিয়ে যায়।

```bash theme={null}
so-me analytics:platform facebook
```

```
  Available sections for Facebook:

  page
  posts
  videos

  Usage: so-me analytics:platform facebook <section> --days <number>
```

**2. অ্যাকাউন্ট UUID + সেকশন নেই**

CLI পুরনো `/v1/analytics/platform/:id` এন্ডপয়েন্ট থেকে সম্মিলিত প্ল্যাটফর্ম সারসংক্ষেপ আনে।

```bash theme={null}
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 --days 30
```

**3. শনাক্তকারী + সেকশন**

CLI সেই নির্দিষ্ট সেকশন আনে। প্ল্যাটফর্ম জানা থাকলে অনুরোধ পাঠানোর আগে উপরের টেবিলের বিপরীতে সেকশন যাচাই করা হয়।

```bash theme={null}
so-me analytics:platform instagram media --days 7
```

### উদাহরণ

```bash theme={null}
# See available sections for a platform
so-me analytics:platform facebook

# Facebook page analytics for the last 30 days
so-me analytics:platform facebook page --days 30

# Instagram media analytics for the last 7 days (default)
so-me analytics:platform instagram media

# YouTube channel analytics for the last 90 days
so-me analytics:platform youtube channel --days 90

# Twitter / X account analytics (twitter is normalized to x)
so-me analytics:platform twitter account

# Combined platform summary by account UUID
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 --days 30

# Section analytics by account UUID
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 posts --days 90

# As a table
so-me analytics:platform facebook page --days 30 --table
```

> [!WARNING]
>
> জানা প্ল্যাটফর্মের জন্য অবৈধ সেকশন দিলে (যেমন `so-me analytics:platform facebook stories`) কমান্ড ব্যর্থ হয় এবং ওই প্ল্যাটফর্মের বৈধ সেকশনের তালিকা প্রিন্ট করে। বর্তমান ওয়ার্কস্পেসে সংযুক্ত নয় এমন অ্যাকাউন্ট UUID সেকশনসহ দিলেও কমান্ড ব্যর্থ হয় — বৈধ অ্যাকাউন্ট খুঁজে পেতে `so-me accounts:list` চালান।

## analytics:post

একটি নির্দিষ্ট পোস্টের পারফরম্যান্স মেট্রিক ID দিয়ে আনুন।

```bash theme={null}
so-me analytics:post <post-id> [options]
```

**post-id** `string` *required*

পোস্টের UUID।

| অপশন | বিবরণ | ডিফল্ট |
| - | - | - |
| `-d, --days <number>` | দিনে পেছনে তাকানোর সময়কাল: `7`, `30` বা `90` | `7` |

### উদাহরণ

```bash theme={null}
# Default 7-day window
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000

# Last 30 days
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000 --days 30

# As a table
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000 --days 90 --table
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.