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

# Account Details

> Get detailed information about an analyzed account

## Overview

This endpoint returns detailed information about a specific analyzed account, including their top performing videos and complete analytics.

### Path Parameters

<ParamField path="accountId" type="string" required>
  The internal account ID (obtained from the list or analyze endpoints)
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  Complete account details including:

  * Profile information (username, display name, bio, avatar)
  * Verification status
  * Statistics (followers, following, videos, likes)
  * Analytics (engagement rate, virality score, average views, share rate, save rate)
  * Top hashtags, music, and keywords
  * Audience insights
  * Posting times analysis
  * Top 20 performing videos
  * Profile URL
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hooked.so/v1/social/account/clx123abc" \
    -H "x-api-key: your_api_key_here"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.hooked.so/v1/social/account/clx123abc', {
    headers: {
      'x-api-key': 'your_api_key_here'
    }
  });

  const data = await response.json();
  console.log(data.data);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.hooked.so/v1/social/account/clx123abc',
      headers={'x-api-key': 'your_api_key_here'}
  )

  account = response.json()['data']
  print(f"Top video: {account['topVideos'][0]['title']}")
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "id": "clx123abc",
      "username": "fitnessguru",
      "platform": "tiktok",
      "displayName": "Fitness Guru",
      "bio": "Helping you get fit one video at a time",
      "avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
      "isVerified": true,
      "stats": {
        "followers": 1500000,
        "following": 250,
        "videos": 342,
        "likes": 45000000
      },
      "analytics": {
        "engagementRate": 12.5,
        "viralityScore": 78.3,
        "avgViews": 890000,
        "shareRate": 2.3,
        "saveRate": 4.1
      },
      "topHashtags": ["fitness", "workout", "gym", "motivation", "health"],
      "topMusic": ["Workout Beats", "Gym Motivation", "Running Mix"],
      "keywords": ["fitness", "exercise", "motivation", "health"],
      "keywordsStatus": "completed",
      "audience": {
        "ageGroups": ["18-24", "25-34"],
        "interests": ["fitness", "health", "lifestyle"]
      },
      "postingTimes": [
        { "day": "Monday", "hour": 9, "engagement": 15.2 },
        { "day": "Wednesday", "hour": 18, "engagement": 18.5 }
      ],
      "topVideos": [
        {
          "id": "video123",
          "externalId": "7234567890123456789",
          "title": "5 minute ab workout",
          "thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
          "views": 5400000,
          "likes": 890000,
          "viralScore": 92.5,
          "publishedAt": "2024-01-15T10:30:00Z"
        }
      ],
      "lastAnalyzed": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-01T00:00:00Z",
      "profileUrl": "https://www.tiktok.com/@fitnessguru"
    }
  }
  ```
</ResponseExample>

<Tip>
  Use the `topVideos` data to understand what content performs best for this creator and apply similar strategies to your own content.
</Tip>


## OpenAPI

````yaml GET /v1/social/account/{accountId}
openapi: 3.0.0
info:
  title: Hooked API
  version: 1.0.0
  description: AI Video Generation API
servers:
  - url: https://api.hooked.so
security:
  - ApiKeyAuth: []
paths:
  /v1/social/account/{accountId}:
    get:
      tags:
        - Social Accounts
      summary: Account Details
      description: Get detailed information about an analyzed account
      operationId: getSocialAccount
      parameters:
        - name: accountId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````