User Analytics

GET/tw-v2/interaction/user-analytics

Description

Get detailed analytics for a user including engagement rates and growth metrics.

Parameters

Parameter	Type	Required	Description
authToken	string	required	Twitter authentication token (auth_token cookie value)
toTime	string	optional	End time for analytics period in ISO 8601 format (default: current time)
fromTime	string	optional	Start time for analytics period in ISO 8601 format (default: 30 days ago)
granularity	string	optional	Time granularity for metrics: Daily, Weekly, or Monthly (default: Daily)
showVerifiedFollowers	boolean	optional	Include verified follower metrics (default: true)
proxy	string	optional	Optional proxy in format 'host:port@user:pass'

Code Examples

const params = new URLSearchParams({
  authToken: 'YOUR_AUTH_TOKEN'
});

const response = await fetch(`https://api.tweetapi.com/tw-v2/interaction/user-analytics?${params}`, {
  method: 'GET',
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

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

Response

Success Response (200 OK)

200

{
  "data": {
    "__typename": "User",
    "verified_follower_count": "0",
    "relationship_counts": {
      "followers": 0
    },
    "organic_metrics_time_series": [
      {
        "metric_values": [
          {
            "metric_value": 1,
            "metric_type": "Engagements"
          },
          {
            "metric_type": "Impressions"
          },
          {
            "metric_type": "ProfileVisits"
          },
          {
            "metric_value": 1,
            "metric_type": "Follows"
          },
          {
            "metric_type": "Replies"
          },
          {
            "metric_type": "Likes"
          },
          {
            "metric_type": "Retweets"
          },
          {
            "metric_type": "Bookmark"
          },
          {
            "metric_type": "Share"
          },
          {
            "metric_type": "UrlClicks"
          },
          {
            "metric_type": "CreateTweet"
          },
          {
            "metric_type": "CreateQuote"
          },
          {
            "metric_type": "Unfollows"
          },
          {
            "metric_type": "CreateReply"
          }
        ],
        "timestamp": {
          "iso8601_time": "2025-09-28T00:00:00Z"
        }
      },
      {
        "metric_values": [
          {
            "metric_type": "Engagements"
          },
          {
            "metric_value": 15,
            "metric_type": "Impressions"
          },
          {
            "metric_type": "ProfileVisits"
          },
          {
            "metric_type": "Follows"
          },
          {
            "metric_type": "Replies"
          },
          {
            "metric_type": "Likes"
          },
          {
            "metric_type": "Retweets"
          },
          {
            "metric_type": "Bookmark"
          },
          {
            "metric_type": "Share"
          },
          {
            "metric_type": "UrlClicks"
          },
          {
            "metric_value": 6,
            "metric_type": "CreateTweet"
          },
          {
            "metric_type": "CreateQuote"
          },
          {
            "metric_type": "Unfollows"
          },
          {
            "metric_type": "CreateReply"
          }
        ],
        "timestamp": {
          "iso8601_time": "2025-10-06T00:00:00Z"
        }
      },
      {
        "metric_values": [
          {
            "metric_value": 8,
            "metric_type": "Engagements"
          },
          {
            "metric_value": 27,
            "metric_type": "Impressions"
          },
          {
            "metric_type": "ProfileVisits"
          },
          {
            "metric_type": "Follows"
          },
          {
            "metric_value": 3,
            "metric_type": "Replies"
          },
          {
            "metric_type": "Likes"
          },
          {
            "metric_type": "Retweets"
          },
          {
            "metric_type": "Bookmark"
          },
          {
            "metric_type": "Share"
          },
          {
            "metric_type": "UrlClicks"
          },
          {
            "metric_value": 11,
            "metric_type": "CreateTweet"
          },
          {
            "metric_type": "CreateQuote"
          },
          {
            "metric_type": "Unfollows"
          },
          {
            "metric_value": 1,
            "metric_type": "CreateReply"
          }
        ],
        "timestamp": {
          "iso8601_time": "2025-10-07T00:00:00Z"
        }
      }
    ],
    "id": "VXNlcjoxNzk2ODA4NjQ0NzI3ODg5OTIw"
  }
}

User Analytics

Description

Parameters

Code Examples

Response

Success Response (200 OK)

API Playground

Sensitive Credentials Required