# X (Twitter) Engagement API. Send a handle or profile link.

Engagement rate, views per post and posting cadence. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dx.engagement)

[In your agent: **X (Twitter) MCP server** →](https://socialtap.dev/mcp/x/index.md)

## X (Twitter) Engagement API at a glance

Returns a public X (formerly Twitter) account's engagement rate over its latest posts, with the profile and posts, from a username, link or ID. The rate is per follower and per view, as mean, median and spread. You also get views, likes, replies, reposts, quotes and bookmarks per post, the reply-to-like ratio, posting cadence, the mix of text, photo and video posts, and the top and bottom post with how each compares with a typical one.

GET `/v1/x/engagement`

[Read the API reference](https://socialtap.dev/docs/reference/x/engagement/index.md)

- **1 credit** per request, $0.75–$1.97 per 1,000 requests
- **12 typed fields** null when unknown
- **`handle`** is all it needs, e.g. `NASA`
- **100 credits** free when you sign up, no card, so you can build before you spend

## Send one request. Get 12 fields back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

`$ npm install socialtap`

`handle = NASA`

[Open in playground](https://socialtap.dev/playground/?endpoint=x.engagement)

cURL:

```shell
curl 'https://socialtap.dev/v1/x/engagement?handle=NASA' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.x.engagement.get({ handle: "NASA" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  handle: "NASA",
});
const res = await fetch(`https://socialtap.dev/v1/x/engagement?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/x/engagement",
    params={"handle": "NASA"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("handle", "NASA")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/x/engagement?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": {
    "approximate_fields": [],
    "bottom_post_id": "2120910178711466211",
    "id": "11348282",
    "metrics": {
      "comment_to_like_ratio": 0.053345,
      "comments_per_post": 188.56,
      "counted_post_count": 9,
      "engagement_rate": 0.00004,
      "engagement_rate_stddev": 0.000022,
      "formats": [
        {
          "counted_post_count": 5,
          "engagement_rate": 0.000051,
          "interactions_per_post": 4722,
          "type": "image",
          "views_per_post": 687646.8
        },
        {
          "counted_post_count": 2,
          "engagement_rate": 0.000032,
          "interactions_per_post": 2968,
          "type": "video",
          "views_per_post": 911061.5
        },
        {
          "counted_post_count": 1,
          "engagement_rate": 0.000021,
          "interactions_per_post": 1958,
          "type": "carousel",
          "views_per_post": 570219
        }
      ],
      "interactions_per_post": 3723.22,
      "likes_per_post": 3534.67,
      "median_engagement_rate": 0.000033,
      "median_views_per_post": 686019,
      "posts_per_week": 9.7,
      "quotes_per_post": 42.44,
      "rated_post_count": 9,
      "reposts_per_post": 534.56,
      "sampled_post_count": 20,
      "saves_per_post": 200.11,
      "shares_per_post": null,
      "view_engagement_rate": 0.00515,
      "views_per_post": 734071.67
    },
    "newest_post_at": "2026-11-13T16:35:39Z",
    "oldest_post_at": "2026-11-07T22:00:32Z",
    "platform": "x",
    "platform_specific": {},
    "posts": [
      {
        "engagement_rate": null,
        "engagement_vs_median": null,
        "is_counted": false,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg",
            "display_name": "NASA",
            "id": "11348282",
            "is_verified": true,
            "url": "https://x.com/NASA",
            "username": "NASA"
          },
          "coauthors": [],
          "duration_ms": 146453,
          "hashtags": [],
          "id": "2121364270281822467",
          "is_nsfw": false,
          "is_pinned": false,
          "is_sponsored": null,
          "language": "en",
          "link_url": null,
          "media": [
            {
              "alt_text": null,
              "duration_ms": 146453,
              "expires_at": null,
              "height": 1920,
              "thumbnail_url": "https://pbs.twimg.com/media/HXCYS3DXAAECK2q.jpg",
              "type": "video",
              "url": "https://video.twimg.com/amplify_video/2121361933618028544/vid/avc1/2160x3840/oG4NNepP1wwmyakn.mp4?tag=29",
              "width": 1080
            }
          ],
          "mentions": [
            "NASA",
            "NASAKennedy"
          ],
          "metrics": {
            "comment_count": 21,
            "like_count": 394,
            "quote_count": 15,
            "repost_count": 49,
            "save_count": 24,
            "share_count": null,
            "view_count": 186365
          },
          "platform": "x",
          "platform_specific": {
            "x": {
              "article": null,
              "author_metrics": {
                "follower_count": 92248931,
                "following_count": 115,
                "post_count": 74542,
                "total_like_count": null,
                "total_view_count": null
              },
              "author_verified_type": "government",
              "card": null,
              "cashtags": [],
              "community": null,
              "conversation_id": "2121364270281822467",
              "edit_post_ids": [
                "2121364270281822467"
              ],
              "is_author_blue_verified": true,
              "is_edited": false,
              "links": [],
              "media_variants": [
                {
                  "bitrate": null,
                  "content_type": "application/x-mpegURL",
                  "media_index": 0,
                  "url": "https://video.twimg.com/amplify_video/2121361933618028544/pl/xy0v5EVwWxCRpn0r.m3u8?tag=29&v=9cc"
                },
                {
                  "bitrate": 632000,
                  "content_type": "video/mp4",
                  "media_index": 0,
                  "url": "https://video.twimg.com/amplify_video/2121361933618028544/vid/avc1/320x568/B8BqN_MwauDVMGRU.mp4?tag=29"
                },
                {
                  "bitrate": 950000,
                  "content_type": "video/mp4",
                  "media_index": 0,
                  "url": "https://video.twimg.com/amplify_video/2121361933618028544/vid/avc1/480x852/RYeJilwHgLY5DLnR.mp4?tag=29"
                }
              ],
              "poll": null,
              "quoted_post": null,
              "quoted_post_id": null,
              "reply_to_author": null,
              "reply_to_post_id": null,
              "reposted_post": {
                "author": {
                  "avatar_url": "https://pbs.twimg.com/profile_images/2094450130237755392/4TkxuQxN.jpg",
                  "display_name": "NASA Spox",
                  "id": "1907894348319973378",
                  "is_verified": true,
                  "url": "https://x.com/NASASpox",
                  "username": "NASASpox"
                },
                "id": "2121362987902464316",
                "media": [
                  {
                    "alt_text": null,
                    "duration_ms": 146453,
                    "expires_at": null,
                    "height": 1920,
                    "thumbnail_url": "https://pbs.twimg.com/media/HXCYS3DXAAECK2q.jpg",
                    "type": "video",
                    "url": "https://video.twimg.com/amplify_video/2121361933618028544/vid/avc1/2160x3840/oG4NNepP1wwmyakn.mp4?tag=29",
                    "width": 1080
                  }
                ],
                "metrics": {
                  "comment_count": 21,
                  "like_count": 394,
                  "quote_count": 15,
                  "repost_count": 49,
                  "save_count": 24,
                  "share_count": null,
                  "view_count": 186365
                },
                "published_at": "2026-11-13T22:02:03Z",
                "text": "From MAX POWER to Mars, it was a week to remember at @NASA!\n\n🇺🇸 MAX POWER takes over @NASAKennedy\n🌕 New Moon Base awards\n✈️ X-70 Fractal unveiled\n🧑‍🚀 Astronaut recruitment opened\n🔴CHAPEA Mars simulation concludes\n🛰️ ESCAPADE sets off to Mars\n\nHere’s your NASA Minute!",
                "url": "https://x.com/NASASpox/status/2121362987902464316"
              },
              "reposted_post_id": "2121362987902464316",
              "source": "Twitter Web App"
            }
          },
          "platform_type": "repost",
          "published_at": "2026-11-13T22:07:09Z",
          "text": "From MAX POWER to Mars, it was a week to remember at @NASA!\n\n🇺🇸 MAX POWER takes over @NASAKennedy\n🌕 New Moon Base awards\n✈️ X-70 Fractal unveiled\n🧑‍🚀 Astronaut recruitment opened\n🔴CHAPEA Mars simulation concludes\n🛰️ ESCAPADE sets off to Mars\n\nHere’s your NASA Minute!",
          "thumbnail_url": "https://pbs.twimg.com/media/HXCYS3DXAAECK2q.jpg",
          "title": null,
          "type": "video",
          "unknown_fields": [],
          "url": "https://x.com/NASA/status/2121364270281822467"
        },
        "view_engagement_rate": null,
        "views_vs_median": null
      },
      {
        "engagement_rate": 0.000055,
        "engagement_vs_median": 1.66,
        "is_counted": true,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg",
            "display_name": "NASA",
            "id": "11348282",
            "is_verified": true,
            "url": "https://x.com/NASA",
            "username": "NASA"
          },
          "coauthors": [],
          "duration_ms": null,
          "hashtags": [],
          "id": "2121280846183137564",
          "is_nsfw": false,
          "is_pinned": false,
          "is_sponsored": null,
          "language": "en",
          "link_url": null,
          "media": [
            {
              "alt_text": "An artist's concept of the Voyager spacecraft, with its long antenna pointing down and to the right in the direction of Earth. Earth isn't visible in the image, but Voyager is among the stars. In the background, there is also a long, deep blue ribbon of gas and dust stretching fr…",
              "duration_ms": null,
              "expires_at": null,
              "height": 1058,
              "thumbnail_url": null,
              "type": "image",
              "url": "https://pbs.twimg.com/media/HXBNsEVWgAAsCUY.jpg?name=orig",
              "width": 1280
            }
          ],
          "mentions": [],
          "metrics": {
            "comment_count": 188,
            "like_count": 4865,
            "quote_count": 52,
            "repost_count": 856,
            "save_count": 331,
            "share_count": null,
            "view_count": 660368
          },
          "platform": "x",
          "platform_specific": {
            "x": {
              "article": null,
              "author_metrics": {
                "follower_count": 92248931,
                "following_count": 115,
                "post_count": 74542,
                "total_like_count": null,
                "total_view_count": null
              },
              "author_verified_type": "government",
              "card": null,
              "cashtags": [],
              "community": null,
              "conversation_id": "2121280846183137564",
              "edit_post_ids": [
                "2121280846183137564"
              ],
              "is_author_blue_verified": true,
              "is_edited": false,
              "links": [
                {
                  "title": "go.nasa.gov/4k942pz",
                  "url": "https://go.nasa.gov/4k942pz"
                }
              ],
              "media_variants": [],
              "poll": null,
              "quoted_post": null,
              "quoted_post_id": null,
              "reply_to_author": null,
              "reply_to_post_id": null,
              "reposted_post": null,
              "reposted_post_id": null,
              "source": null
            }
          },
          "platform_type": "post",
          "published_at": "2026-11-13T16:35:39Z",
          "text": "Let's talk about Voyager 1 and 2!\n \nJoin us Nov. 19 for a status update on the twin probes and a discussion of their unique mission. Plus, we'll have a Q&A session and a sneak peek at the upcoming NASA+ Voyager documentary. https://go.nasa.gov/4k942pz",
          "thumbnail_url": "https://pbs.twimg.com/media/HXBNsEVWgAAsCUY.jpg?name=orig",
          "title": null,
          "type": "image",
          "unknown_fields": [],
          "url": "https://x.com/NASA/status/2121280846183137564"
        },
        "view_engagement_rate": 0.007652,
        "views_vs_median": 0.96
      },
      {
        "engagement_rate": null,
        "engagement_vs_median": null,
        "is_counted": false,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg",
            "display_name": "NASA",
            "id": "11348282",
            "is_verified": true,
            "url": "https://x.com/NASA",
            "username": "NASA"
          },
          "coauthors": [],
          "duration_ms": null,
          "hashtags": [],
          "id": "2121232295902265768",
          "is_nsfw": false,
          "is_pinned": false,
          "is_sponsored": null,
          "language": "en",
          "link_url": null,
          "media": [
            {
              "alt_text": "Poster reading “Journey to Titan: Fly your name to another world!” showing NASA’s Dragonfly rotorcraft flying over Titan’s orange dunes above two sample Dragonfly boarding passes, one in English and one in Spanish.",
              "duration_ms": null,
              "expires_at": null,
              "height": 5626,
              "thumbnail_url": null,
              "type": "image",
              "url": "https://pbs.twimg.com/media/HW9GgYiX0AAuyCl.jpg?name=orig",
              "width": 4500
            }
          ],
          "mentions": [],
          "metrics": {
            "comment_count": 61,
            "like_count": 1673,
            "quote_count": 58,
            "repost_count": 355,
            "save_count": 331,
            "share_count": null,
            "view_count": 217604
          },
          "platform": "x",
          "platform_specific": {
            "x": {
              "article": null,
              "author_metrics": {
                "follower_count": 92248931,
                "following_count": 115,
                "post_count": 74542,
                "total_like_count": null,
                "total_view_count": null
              },
              "author_verified_type": "government",
              "card": null,
              "cashtags": [],
              "community": null,
              "conversation_id": "2121232295902265768",
              "edit_post_ids": [
                "2121232295902265768"
              ],
              "is_author_blue_verified": true,
              "is_edited": false,
              "links": [
                {
                  "title": "go.nasa.gov/dragonfly-names",
                  "url": "https://go.nasa.gov/dragonfly-names"
                }
              ],
              "media_variants": [],
              "poll": null,
              "quoted_post": null,
              "quoted_post_id": null,
              "reply_to_author": null,
              "reply_to_post_id": null,
              "reposted_post": {
                "author": {
                  "avatar_url": "https://pbs.twimg.com/profile_images/1852211324224442369/9KHp7JLo.jpg",
                  "display_name": "NASA Solar System",
                  "id": "15165493",
                  "is_verified": true,
                  "url": "https://x.com/NASASolarSystem",
                  "username": "NASASolarSystem"
                },
                "id": "2120993164987441157",
                "media": [
                  {
                    "alt_text": "Poster reading “Journey to Titan: Fly your name to another world!” showing NASA’s Dragonfly rotorcraft flying over Titan’s orange dunes above two sample Dragonfly boarding passes, one in English and one in Spanish.",
                    "duration_ms": null,
                    "expires_at": null,
                    "height": 5626,
                    "thumbnail_url": null,
                    "type": "image",
                    "url": "https://pbs.twimg.com/media/HW9GgYiX0AAuyCl.jpg?name=orig",
                    "width": 4500
                  }
                ],
                "metrics": {
                  "comment_count": 61,
                  "like_count": 1673,
                  "quote_count": 58,
                  "repost_count": 355,
                  "save_count": 331,
                  "share_count": null,
                  "view_count": 217604
                },
                "published_at": "2026-11-12T21:32:31Z",
                "text": "🎟️ Got your ticket to Titan?\n\nAdd your name to fly aboard NASA’s Dragonfly mission and join the Dragonflyers headed for Saturn's largest moon!\n\nSecure your seat today: https://go.nasa.gov/dragonfly-names",
                "url": "https://x.com/NASASolarSystem/status/2120993164987441157"
              },
              "reposted_post_id": "2120993164987441157",
              "source": "Twitter for iPhone"
            }
          },
          "platform_type": "repost",
          "published_at": "2026-11-13T13:22:44Z",
          "text": "🎟️ Got your ticket to Titan?\n\nAdd your name to fly aboard NASA’s Dragonfly mission and join the Dragonflyers headed for Saturn's largest moon!\n\nSecure your seat today: https://go.nasa.gov/dragonfly-names",
          "thumbnail_url": "https://pbs.twimg.com/media/HW9GgYiX0AAuyCl.jpg?name=orig",
          "title": null,
          "type": "image",
          "unknown_fields": [],
          "url": "https://x.com/NASA/status/2121232295902265768"
        },
        "view_engagement_rate": null,
        "views_vs_median": null
      }
    ],
    "profile": {
      "approximate_fields": [],
      "avatar_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg",
      "banner_url": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
      "bio": "Making the seemingly impossible, possible. ✨",
      "category": null,
      "country_code": null,
      "created_at": "2007-12-19T20:20:32Z",
      "display_name": "NASA",
      "external_links": [
        {
          "title": "nasa.gov",
          "url": "http://www.nasa.gov/"
        }
      ],
      "id": "11348282",
      "is_private": false,
      "is_verified": true,
      "location": "Pale Blue Dot",
      "metrics": {
        "follower_count": 92248931,
        "following_count": 115,
        "post_count": 74542,
        "total_like_count": null,
        "total_view_count": null
      },
      "platform": "x",
      "platform_specific": {
        "x": {
          "affiliation": null,
          "highlighted_post_count": 292,
          "is_blue_verified": true,
          "is_identity_verified": false,
          "is_possibly_sensitive": false,
          "like_count": 17110,
          "listed_count": 96867,
          "media_count": 28249,
          "pinned_post_ids": [],
          "professional_type": null,
          "verified_at": "2009-08-07T19:53:50Z",
          "verified_type": "government",
          "withheld_in_countries": []
        }
      },
      "type": "organization",
      "unknown_fields": [],
      "url": "https://x.com/NASA",
      "username": "NASA"
    },
    "top_post_id": "2120974110335312297",
    "unknown_fields": [],
    "url": "https://x.com/NASA"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "x",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1000,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": "11348282",
      "url": "https://x.com/NASA"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 8 platforms.

The [response reference](https://socialtap.dev/docs/reference/x/engagement/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/engagement/index.md).

- ### Null means unknown

  A field X doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### What it accepts

  X account: a username with or without the @ (NASA, @NASA), a numeric user ID (11348282), or a profile link (x.com/NASA or twitter.com/NASA, with or without a tab such as /media or /with_replies, mobile.twitter.com, x.com/i/user/11348282, a Follow-button or intent link such as x.com/intent/user?screen_name=NASA or ?user_id=11348282, with any query such as ?s=20).
- ### Write one parser

  X, TikTok, Instagram and 5 more platforms answer in these fields, so the code that reads one reads them all.

- **`platform`string**: Platform ID (tiktok, instagram, …).
- **`id`string**: Platform-native account ID (equals profile.id).
- **`url`string**: Canonical profile URL (equals profile.url).
- **`profile`object**: The account, as its profile endpoint returns it; its metrics.follower_count divides every engagement_rate.
- **`posts`object\[\]**: The sampled recent posts in the profile's order, each with its own figures. \[\] when none; \[\] and in unknown_fields when unreadable (a private account, a failed posts request).
- **`metrics`object**: Figures over the counted posts (by the account, not pinned, no reposts); each null when no counted post has its inputs.
- **`oldest_post_at`string**: Publish time of the oldest counted post, RFC 3339 UTC: where the sample starts.
- **`newest_post_at`string**: Publish time of the newest counted post, RFC 3339 UTC: when the account last posted.

Live data from 35 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [GitHub](https://socialtap.dev/apis/github/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Hacker News](https://socialtap.dev/apis/hackernews/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/page/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/profile/index.md) · [Linkme](https://socialtap.dev/apis/linkme/profile/index.md) · [Linktree](https://socialtap.dev/apis/linktree/profile/index.md) · [Pillar](https://socialtap.dev/apis/pillar/page/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## What teams build with the X (Twitter) Engagement API.

- ### Audit an account's engagement before a campaign
- ### Compare engagement across a list of accounts
- ### Track posting cadence and engagement over time
- ### Spot an account's best and worst posts

## Good to know before you build.

- The figures cover the account's latest posts, the first page of the X (Twitter) User Posts API. The profile and posts match the X (Twitter) Profile and User Posts APIs.
- X shows logged-out visitors one of two lists for each account. For accounts it shows by their timeline, mostly organizations, the sample is their latest posts and reposts. For the others it is their latest few own posts, from their profile page.
- Reposts are listed with is_counted false and left out of the figures, as their counts are the reposted post's. Pinned posts are listed and left out too.
- Engagement rate counts likes plus replies, per follower and per view. X shows no view count for posts from before December 2022, so the per-view figures leave those out.
- A protected account returns its profile with posts listed in unknown_fields and every figure null. When the posts can't be read, the same answer carries a partial_data warning. Unknown and suspended accounts return not_found.
- When X's API fails, both come from the profile page, which lacks the media, like and list counts.

## 1 credit per request. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/x/engagement/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful request | Per 1,000 requests |
| --- | --- | --- |
| Any source | 1 credit | $0.75–$1.97 |

- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

## Questions about the X (Twitter) Engagement API.

More in the [API reference](https://socialtap.dev/docs/reference/x/engagement/index.md).

**How is the engagement rate computed?**

Likes plus replies over the follower count, for each counted post. metrics.engagement_rate is the mean over those posts, beside its median and spread, and view_engagement_rate is the same per view.

**Do reposts count toward the engagement rate?**

No. A repost carries the reposted post's likes and views, so it is listed with is_counted false and left out of every figure.

**How much does the X (Twitter) Engagement API cost?**

A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

Other platforms

## Engagement stats on 7 more platforms.

- [TikTok Engagement API](https://socialtap.dev/apis/tiktok/engagement/index.md) (1 credit · `GET /v1/tiktok/engagement`)
- [Instagram Engagement API](https://socialtap.dev/apis/instagram/engagement/index.md) (1 credit · `GET /v1/instagram/engagement`)
- [Facebook Engagement API](https://socialtap.dev/apis/facebook/engagement/index.md) (1 credit · `GET /v1/facebook/engagement`)
- [YouTube Engagement API](https://socialtap.dev/apis/youtube/engagement/index.md) (1 credit · `GET /v1/youtube/engagement`)
- [Reddit Engagement API](https://socialtap.dev/apis/reddit/engagement/index.md) (1 credit · `GET /v1/reddit/engagement`)
- [LinkedIn Engagement API](https://socialtap.dev/apis/linkedin/engagement/index.md) (From 1 credit · `GET /v1/linkedin/engagement`)
- [Rumble Engagement API](https://socialtap.dev/apis/rumble/engagement/index.md) (1 credit · `GET /v1/rumble/engagement`)

More X

## X API. 17 endpoints, one key.

- [X (Twitter) Post API](https://socialtap.dev/apis/x/post/index.md) (1 credit · `GET /v1/x/post`)
- [X (Twitter) Mentions API](https://socialtap.dev/apis/x/profile-mentions/index.md) (1 credit / page · `GET /v1/x/profile_mentions`)
- [X (Twitter) User Posts API](https://socialtap.dev/apis/x/posts/index.md) (1 credit / page · `GET /v1/x/posts`)
- [X (Twitter) Community Posts API](https://socialtap.dev/apis/x/community-posts/index.md) (1 credit / page · `GET /v1/x/community_posts`)
- [X (Twitter) Profile API](https://socialtap.dev/apis/x/profile/index.md) (1 credit · `GET /v1/x/profile`)
- [X (Twitter) List Followers API](https://socialtap.dev/apis/x/list-followers/index.md) (1 credit / page · `GET /v1/x/list_followers`)
- [X (Twitter) Comments API](https://socialtap.dev/apis/x/comments/index.md) (1 credit / page · `GET /v1/x/comments`)
- [X (Twitter) Video Transcript API](https://socialtap.dev/apis/x/transcript/index.md) (From 1 credit · `GET /v1/x/transcript`)
- [X (Twitter) Post Search API](https://socialtap.dev/apis/x/search-posts/index.md) (From 1 credit / page · `GET /v1/x/search_posts`)
- [X (Twitter) User Search API](https://socialtap.dev/apis/x/search-profiles/index.md) (From 1 credit / page · `GET /v1/x/search_profiles`)
- [X (Twitter) Hashtag Search API](https://socialtap.dev/apis/x/search-hashtags/index.md) (1 credit / page · `GET /v1/x/search_hashtags`)
- [X (Twitter) Community Search API](https://socialtap.dev/apis/x/search-communities/index.md) (From 1 credit / page · `GET /v1/x/search_communities`)
- [X (Twitter) List API](https://socialtap.dev/apis/x/list/index.md) (1 credit · `GET /v1/x/list`)
- [X (Twitter) Community API](https://socialtap.dev/apis/x/community/index.md) (1 credit · `GET /v1/x/community`)
- [X (Twitter) Spaces API](https://socialtap.dev/apis/x/space/index.md) (1 credit · `GET /v1/x/space`)
- [X (Twitter) Friendship API](https://socialtap.dev/apis/x/friendship/index.md) (1 credit · `GET /v1/x/friendship`)

## Try it on an account you know.

Paste its handle or link in the playground, or copy the request into your code.

100free credits

- No credit card
- Failed requests are free
- Works on all 276 endpoints

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/x/engagement/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
