> ## 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.

# Refresh Account

> Refresh account data with latest information from the platform

## Overview

This endpoint refreshes an analyzed account with the latest data from the platform. Use this to update follower counts, engagement metrics, and discover new content.

### Path Parameters

<ParamField path="accountId" type="string" required>
  The internal account ID to refresh
</ParamField>

### Response

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

<ResponseField name="message" type="string">
  Status message
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="account" type="object">
      The refreshed account with updated data
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.hooked.so/v1/social/account/clx123abc/refresh" \
    -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/refresh', {
    method: 'POST',
    headers: {
      'x-api-key': 'your_api_key_here'
    }
  });

  const data = await response.json();
  console.log('Account refreshed:', data.data.account);
  ```

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

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

  account = response.json()['data']['account']
  print(f"Updated followers: {account['stats']['followers']}")
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "message": "Account refreshed successfully",
    "data": {
      "account": {
        "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": 1520000,
          "following": 252,
          "videos": 348,
          "likes": 46500000
        },
        "analytics": {
          "engagementRate": 12.8,
          "viralityScore": 79.1,
          "avgViews": 920000
        },
        "lastAnalyzed": "2024-01-16T10:30:00Z",
        "profileUrl": "https://www.tiktok.com/@fitnessguru"
      }
    }
  }
  ```
</ResponseExample>

<Note>
  Refreshing an account will scrape the latest data from the platform and may consume API credits.
</Note>

<Tip>
  Set up a scheduled refresh to track account growth over time. Consider refreshing accounts weekly to monitor performance trends.
</Tip>


## OpenAPI

````yaml POST /v1/social/account/{accountId}/refresh
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}/refresh:
    post:
      tags:
        - Social Accounts
      summary: Refresh Account
      description: Refresh account data with latest information from the platform
      operationId: refreshSocialAccount
      parameters:
        - name: accountId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Account refreshed successfully
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````