Twitter (X) Account Audit – Engagement

sfoln/x-account-overview · Social media, Lead generation, Automation On request

Audit any public X (Twitter) account in one row: profile, followers and bio plus average likes, reposts, replies and views, engagement rate, posting frequency and top hashtags over its ~20 latest posts. $12 per 1,000 accounts; unknown or suspended accounts are free.

Request access Run it$0.012 each x account overview, more below

About

What it does

Twitter (X) Account Audit – Engagement gives a one-row health check for any public X (Twitter) account: the full profile (followers, following, posts, verification, bio, website, creation date) plus engagement analytics computed over its ~20 latest posts: average likes, reposts, replies and views, median likes, engagement rate, posting frequency, share of replies and reposts, top hashtags and mentions, last post date and the most-liked recent post. Ideal for influencer vetting, competitor benchmarking, brand-account audits, lead scoring and agency reporting.

Price

Price per delivered record

Event	Price	Per 1,000	Charged for
X account overview `x-account-overview`	$0.012	$12 / 1,000	Charged once per account for which the profile and engagement stats over its latest posts were delivered.
X profile snapshot `x-account-profile-only`	$0.003	$3 / 1,000	Charged instead of x-account-overview when only the profile could be delivered (the posts request failed or the account has no public posts).

Apify free plan: up to 10 items per run. Paid plans have no per-run cap; set maxTotalChargeUsd to cap spend.

Run

Call it from code, an agent or the Console

This API is private on Apify for now. Email us and we will publish it for you, usually within two working days. The calls below work once it is public. contact@sfoln.com

curl · synchronous run, rows in the response

curl -X POST "https://api.apify.com/v2/actors/sfoln~x-account-overview/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"handles":["apify"]}'

mcp.json · hosted Apify MCP server

{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=sfoln/x-account-overview"
    }
  }
}

asynchronous run · for large batches

POST https://api.apify.com/v2/actors/sfoln~x-account-overview/runs?maxTotalChargeUsd=1
GET  https://api.apify.com/v2/actor-runs/{runId}            # until status is SUCCEEDED
GET  https://api.apify.com/v2/datasets/{defaultDatasetId}/items?format=json

Authenticate with an Apify API token. MCP clients can instead sign in with OAuth when prompted. Example prompt for an agent: Audit the X accounts @apify and @NASA: compare followers, engagement rate, average views and how often they post.

Input

Input fields

Paste X (Twitter) handles. For each account the Actor returns the profile plus engagement statistics computed over its ~20 latest posts.

Field	Type	Default	Meaning
`handles` *	`array`	required	Handles or profile URLs X handles (with or without @) or profile URLs, one per line. Duplicates are removed. Accounts on the Apify free plan can process up to 10 accounts per run.
`includeReplies`	`boolean`	`false`	Include replies in the sample Sample the timeline including the account's replies (makes shareOfReplies meaningful; engagement stats always use original posts only, so fewer posts may be analyzed).
`maxItems`	`integer`	`1000`	Max accounts Safety cap on the number of accounts processed in this run. Range 1–10000.
`concurrency`	`integer`	`3`	Concurrency Accounts processed in parallel (1–5). Range 1–5.
`includeRaw`	`boolean`	`false`	Include raw upstream response Attach the unmodified TwitterAPI.io profile and posts under `raw`.

Example input

{
  "handles": [
    "apify"
  ]
}

Output

One record per input item

Records land in the run's dataset; a synchronous call returns them directly. Each has a status (ok is charged; everything else is free) and a charged flag. The run's OUTPUT record totals items and charges.

Field	Type	Meaning
`input`	`string \| object`	Input The input item this record corresponds to.
`status`	`string`	Status ok (full overview, or profile-only with a warning) \| not_found (unknown / suspended account, not charged) \| error \| skipped_invalid \| skipped_budget \| skipped_free_plan e.g. `"ok"`
`charged`	`boolean`	Charged Whether this record incurred a pay-per-event charge.
`chargedEvent`	`string`	Charged event Pay-per-event event charged for this record.
`source`	`string`	Source Upstream data source (twitterapi = TwitterAPI.io).
`fetchedAt`	`string`	Fetched at ISO timestamp.
`error`	`object`	Error code / message when status is not ok.
`warnings`	`array`	Warnings Non-fatal notes (e.g. stopped early).
`found`	`boolean \| null`	Found Account exists and is available.
`handle`	`string \| null`	Handle X handle without @. e.g. `"NASA"`
`userId`	`string \| null`	User id Numeric X user id as a string.
`name`	`string \| null`	Name Display name.
`bio`	`string \| null`	Bio Profile description with t.co links expanded.
`location`	`string \| null`	Location Free-text profile location.
`url`	`string \| null`	Website Website link from the profile (expanded).
`profileUrl`	`string \| null`	Profile URL https://x.com/<handle>.
`followers`	`integer \| null`	Followers Follower count.
`following`	`integer \| null`	Following Accounts followed.
`tweets`	`integer \| null`	Posts Total posts incl. replies and reposts (statusesCount).
`likes`	`integer \| null`	Likes given Posts this account has liked (favouritesCount).
`mediaCount`	`integer \| null`	Media Media posts.
`isBlueVerified`	`boolean \| null`	Blue verified Has a blue check (null when the endpoint does not report it).
`verifiedType`	`string \| null`	Verified type Business / Government / null.
`profileImageUrl`	`string \| null`	Avatar Profile image URL.
`coverImageUrl`	`string \| null`	Banner Banner image URL.
`createdAt`	`string \| null`	Created at ISO 8601 account creation time.
`isAutomated`	`boolean \| null`	Automated Labelled as an automated account.
`automatedBy`	`string \| null`	Automated by Handle of the operator of an automated account.
`canDm`	`boolean \| null`	Can DM Accepts direct messages.
`possiblySensitive`	`boolean \| null`	Possibly sensitive Marked as possibly sensitive.
`withheldInCountries`	`array`	Withheld in Country codes where the account is withheld.
`pinnedTweetIds`	`array`	Pinned post ids Ids of pinned posts.
`unavailable`	`boolean \| null`	Unavailable Account is suspended / deactivated / unavailable.
`unavailableReason`	`string \| null`	Unavailable reason e.g. suspended.
`unavailableMessage`	`string \| null`	Unavailable message Upstream message for unavailable accounts.
`overviewType`	`string \| null`	Overview type full (profile + post stats) \| profile-only (posts could not be fetched or none are public).
`sampleSize`	`integer \| null`	Posts sampled Timeline posts fetched (incl. reposts, excl. pinned).
`postsAnalyzed`	`integer \| null`	Original posts analyzed Original posts (no reposts, no replies) used for engagement stats.
`avgLikes`	`number \| null`	Avg likes Average likes per original post.
`avgRetweets`	`number \| null`	Avg reposts Average reposts per original post.
`avgReplies`	`number \| null`	Avg replies Average replies per original post.
`avgViews`	`number \| null`	Avg views Average views per original post (posts with a view count).
`medianLikes`	`number \| null`	Median likes Median likes per original post.
`engagementRatePct`	`number \| null`	Engagement rate % (avgLikes + avgRetweets + avgReplies) / followers × 100.
`postsPerDay`	`number \| null`	Posts per day Sampled posts / days between the oldest sampled post and fetch time.
`sampleWindowDays`	`number \| null`	Sample window (days) Days between the oldest sampled post and fetch time.
`topHashtags`	`array`	Top hashtags Up to 10 { tag, count } from the account's own posts in the sample.
`topMentions`	`array`	Top mentions Up to 10 { handle, count } from the account's own posts in the sample.
`shareOfReplies`	`number \| null`	Share of replies Replies / sampled posts (0–1).
`shareOfRetweets`	`number \| null`	Share of reposts Reposts / sampled posts (0–1).
`lastPostAt`	`string \| null`	Last post at ISO time of the newest sampled post.
`mostLikedPost`	`object \| null`	Most liked post { id, url, text, likes } among original posts.

Example record

{
  "input": "apify",
  "found": true,
  "handle": "apify",
  "userId": "3018470543",
  "name": "Apify",
  "bio": "Web scraping and automation platform",
  "location": "Prague",
  "url": "https://apify.com",
  "profileUrl": "https://x.com/apify",
  "followers": 12000,
  "following": 300,
  "tweets": 5000,
  "likes": 100,
  "mediaCount": 400,
  "isBlueVerified": true,
  "verifiedType": "Business",
  "createdAt": "2015-02-13T08:00:00.000Z",
  "pinnedTweetIds": [
    "1830000000000000000"
  ],
  "overviewType": "full",
  "sampleSize": 20,
  "postsAnalyzed": 16,
  "avgLikes": 41.5,
  "avgRetweets": 7.25,
  "avgReplies": 3.1,
  "avgViews": 5230.4,
  "medianLikes": 30,
  "engagementRatePct": 0.4296,
  "postsPerDay": 1.43,
  "sampleWindowDays": 14,
  "topHashtags": [
    {
      "tag": "webscraping",
      "count": 5
    },
    {
      "tag": "AI",
      "count": 3
    }
  ],
  "topMentions": [
    {
      "handle": "crawlee",
      "count": 4
    }
  ],
  "shareOfReplies": 0.05,
  "shareOfRetweets": 0.15,
  "lastPostAt": "2026-10-13T14:05:09.000Z",
  "mostLikedPost": {
    "id": "1845000000000000001",
    "url": "https://x.com/apify/status/1845000000000000001",
    "text": "New on the blog …",
    "likes": 210
  },
  "status": "ok",
  "charged": true,
  "chargedEvent": "x-account-overview",
  "source": "twitterapi",
  "fetchedAt": "2026-10-14T10:00:00.000Z"
}

Machine-readable

This page for agents

/actors/x-account-overview.json — this API as JSON
/actors/x-account-overview.md — this API as Markdown
/catalog.json — the whole catalogue